Blender 3D Mastery: A Complete Reference for Claude Code with Blender MCP

Blender 3D Mastery: A Complete Reference for Claude Code with Blender MCP

Load this book when:

• You are controlling Blender via Claude Code and the blender-mcp MCP server.
• You need an exact blender-mcp tool signature before calling any MCP tool (see Ch. 14).
• You need bpy Python API code for a specific Blender operation (mesh, materials, lighting, rendering, animation, geometry nodes).
• You are following a domain workflow: architectural visualization, game assets, product visualization, character modeling, or motion graphics.
• You are debugging a bpy script error or a blender-mcp connection/socket failure.
• You need a ready-to-run code recipe for execute_blender_code (see Ch. 16).

Version: 1.1 Last updated: 2026-06-14 Verified against: Blender 4.5 LTS (released July 15, 2025), blender-mcp ~1.5.x (22 tools, 6 namespaces) Next review: 2026-12-14 Audience: Public marketplace reference Custodian: Marudi ([email protected]) CandleKeep ID: cmpmzvay70ygcrt0zp06xr5ny MCP Target: blender-mcp (all 22 tools) Purpose: A comprehensive reference for Claude Code agents operating Blender via the blender-mcp MCP server. Covers Blender fundamentals, the bpy API, MCP tool signatures, domain workflows, and ready-to-run code recipes.

Blender 4.4/4.5 scope note: This book reflects Blender 4.5 LTS as of the last-updated date above. Key changes since the original 4.x target: Action Slots (4.4, March 2025 — legacy animation API deprecated, removed in 5.0); Vulkan backend production-ready (4.5, July 2025); macOS Intel officially deprecated in 4.5 (final Intel macOS build); Bump/Displacement node distance default changed in 4.5; FBX importer 3-15x faster in 4.5.

Book size note (2026-06-14): This book is 744 pages, exceeding the ~500-page optimal agent-load threshold (Writing Books for AI Agents, Ch. 6, RULE 6.3). For future splits: Chapters 17-22 (Domain Workflows) and Chapter 23 (Expanded Reference) are natural extraction candidates for companion books. Until split, load only the chapter(s) relevant to your current task — do not load the full book.

---

Table of Contents

• Chapter 0: Decision Matrix (Start Here — Routes to All Chapters)

Part I — Blender Foundations

• Chapter 1: Blender Architecture & Data Model
• Chapter 2: Navigation, Workspaces & Interface
• Chapter 3: Objects: Transforms, Origins, Parenting & Instances
• Chapter 4: Mesh Data: Vertices, Edges, Faces, Normals & UVs
• Chapter 5: Mesh Editing & Modeling Techniques
• Chapter 6: Modifiers System (Non-Destructive Modeling)

Part II — Materials, Shading & Rendering

• Chapter 7: Materials & Shader Nodes
• Chapter 8: Lighting: Types, HDRI & Light Probes
• Chapter 9: Cameras: Focal Length, Depth of Field & Composition
• Chapter 10: Rendering: Cycles vs EEVEE

Part III — Advanced Systems

• Chapter 11: Geometry Nodes: Procedural Modeling
• Chapter 12: Scene Management: Collections, Object Properties & Layers
• Chapter 13: Asset Libraries, PolyHaven & External Assets

Part IV — Blender MCP Mastery

• Chapter 14: blender-mcp Tool Reference (Complete — All 22 Tools)
• Chapter 15: Python & bpy API Deep Dive
• Chapter 16: Code Recipes Catalog

Part V — Domain Workflows

• Chapter 17: Architectural Visualization Workflow
• Chapter 18: Game Asset Pipeline
• Chapter 19: Product Visualization Workflow
• Chapter 20: Character & Organic Modeling Workflow
• Chapter 21: Motion Graphics & Animation Workflow
• Chapter 22: Troubleshooting, Errors & Debugging Blender Scripts

---