Control Blender with natural language through MCP. Tell Claude to create a steampunk robot with glowing eyes and watch it build in Blender.
| Download | What it is |
|---|---|
| blender-mcp-*.mcpb | MCP server for Claude Desktop |
| Blender | 3D app (install separately, never bundled) |
| blender_bridge_addon.py (optional) | Live viewport only — skip for headless use |
Steps
- Download the
.mcpbfrom Releases - Drag it into Claude Desktop (Settings → MCP Servers → Install from file)
- Install Blender if you have not already
- Restart Claude Desktop and try: Create a red cube on a gray floor with a sun lamp.
That is enough for most tools — the server runs Blender headless in the background.
Optional — live viewport: install the bridge addon in Blender to watch the scene update while you chat. See INSTALL.md.
Other install methods (npx mcpb, manual config, developer setup): INSTALL.md
| Mode | Host app | When |
|---|---|---|
| Headless (default) | blender --background subprocess |
Batch export, CI, agents without a display; VSE, geonodes, most mesh ops |
| Live GUI (optional) | Blender + bridge addon | Watch the agent build; viewport screenshots; sculpt with live feedback |
| Per-tool override | prefer_session=False |
Batch jobs force headless even if bridge is connected |
You do not need to open Blender's UI for most MCP tools — the server spawns headless Blender automatically and falls back from live session when no bridge is connected.
Install Blender separately; it is never bundled. Override path with BLENDER_EXECUTABLE.
Watch or batch — Most tools run headless. Use
blender_sessionstart + the bridge addon only if you want the viewport to update live. See INSTALL.md.
| Direction | Artifacts | Notes |
|---|---|---|
| Hands-in | Natural-language scene prompts | Agent instructions; blender_ai_* script generation |
| Hands-in | .blend, image refs, mesh files |
Webapp upload or tool params |
| Hands-in | Rodin / Tripo / Hunyuan mesh URLs | blender_ai_generate and related tools |
| Hands-in | Inline bpy scripts |
blender_script_execute, handler-backed tools |
| Hands-out | .glb, .gltf, .fbx, .obj, .usd |
blender_export — headless |
| Hands-out | .vrm, VRChat-ready avatars |
Export + validation pipeline — headless |
| Hands-out | .blend (saved scene) |
After agent edit session — headless or live bridge |
| Hands-out | Viewport PNG, MP4 (VSE), Gaussian splats | blender_render, blender_vse, splat tools — headless |
| Downstream MCP | Takes from blender-mcp |
|---|---|
| godot-mcp | .glb / .gltf game assets |
| vrchat-mcp | .vrm after validation |
| tahoma2d-mcp | Rendered image sequences / GP output |
| freecad-mcp | .step via intermediate export |
| unity3d-mcp | .fbx / .glb for Unity import |
- Natural-language 3D creation — scenes, meshes, materials, lighting, animation
- Live GUI bridge — watch the agent build in Blender while you chat
- 48+ MCP tools — mesh edit, sculpt, geonodes, compositor, VSE, export (GLB, VRM, VRChat, Unity)
- Generative AI hooks — Rodin/Tripo/Hunyuan mesh generation and vision refine
- Webapp dashboard — scene explorer, agent lab, materials, mesh/splat pipeline
- Fleet-ready — FastMCP 3.2,
.mcpbpackaging, Prometheus metrics, optional Docker
Try these in Claude Desktop after install:
Create a red cube on a gray floor with a sun lamp and render a viewport screenshot.
Build a simple chair with wood material and export as GLB.
Start a live Blender session and add a sphere with a metallic blue shader.
| Doc | Contents |
|---|---|
| Installation | All install methods, prerequisites, bridge setup |
| Configuration | Env vars, Claude Desktop env block |
| Tool Reference | Capabilities and tool catalog |
| Development | Contributing, just, lint, build |
| Troubleshooting | Common errors and fixes |
| Architecture | System design |
| Roadmap | Planned improvements |
| Monitoring | Prometheus / Grafana / Loki |
| Docker | Optional container deploy |
Extended guides: docs/DOCUMENTATION_INDEX.md
Dashboard (optional): .\start.ps1 → http://localhost:10848 — see INSTALL.md.
Tauri desktop installer (~15 MB, no Python required): just build-native — see docs/DEVELOPMENT.md.
- Claude Desktop (or any MCP client for manual config)
- Blender 3.0+ — installed separately, never bundled; override with
BLENDER_EXECUTABLE - LLM (optional) — Ollama, LM Studio, or cloud API for script generation; see INSTALL.md
- OS: Windows, macOS, Linux
- Python 3.12+ — only for Options C/D (clone-from-source)
MIT — FlowEngineer sandraschi. Free for personal and commercial use.