Blender Mcp
Headless Blender automation via FastMCP — 41 portmanteau tools (150+ ops). Batch mesh/VSE/Grease Pencil, VRM, Gaussian splats; optional live bridge. For Cursor…
Control Blender with natural language through MCP. Tell Claude to create a steampunk robot with glowing eyes and watch it build in Blender.
Get started in 2 minutes
| 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
How it runs
| 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.
Hands-in / Hands-out
| 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 |
Fleet pipelines (downstream)
From the project's README.