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

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

Webapp and Native App

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.

Requirements

  • 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)

License

MIT — FlowEngineer sandraschi. Free for personal and commercial use.