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…

LLM Mart 1 views 30 listing impressions

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

Stars License Python FastMCP

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

  1. Download the .mcpb from Releases
  2. Drag it into Claude Desktop (Settings → MCP Servers → Install from file)
  3. Install Blender if you have not already
  4. 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_session start + 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.