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…
- Transport
- Not stated
- Package
- —
- Registry id
- —
No install snippet on purpose. A working MCP config is a command, its arguments and an environment block — the last two are where API keys live, so this catalogue never stores them and cannot publish them. Follow the link above for the authors' own instructions.
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.