blender-mcp

Blender MCP — AI-Powered Blender Automation

Control Blender with natural language through MCP. Tell Claude to create a steampunk robot with glowing eyes and watch it build in Blender.

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 Blender. Use blender_session start + enable the bridge addon only if you want the viewport to update live while the agent works. 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)

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

Features

• 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, .mcpb packaging, Prometheus metrics, optional Docker

Quick Install

1. Download blender-mcp-*.mcpb from Releases
2. Drag it into Claude Desktop

Done. Install Blender separately if you have not already.

Other methods (npx mcpb, manual config, developer setup): INSTALL.md

What You Can Do

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.

Documentation