Blender MCP connects an agent to Blender so it can build scenes, run mesh and animation operations, export assets, and render output. It runs Blender headless by default, and can switch to a live viewport when the bridge addon is installed. The repo also ships a dashboard and a Tauri desktop app for managing the workflow and watching the scene pipeline.
Builders who want Cursor or another MCP client to drive Blender scenes, exports, and renders.
You can create and export Blender work from agent prompts instead of opening Blender for every step.
Runs `blender --background` for batch mesh, VSE, Grease Pencil, export, and render jobs.
Uses `addon/blender_bridge_addon.py` to connect a running Blender session when you want to watch updates live.
Exposes dozens of Blender actions through FastMCP, including scene edits, animation, compositing, and export flows.
Includes export and validation paths for VRM avatars, GLB/GLTF assets, and Gaussian splats.
Provides a web dashboard and a Tauri app for scene exploration and pipeline control.
Control Blender with natural language through MCP. Tell Claude to create a steampunk robot with glowing eyes and watch it build in Blender.
| 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
.mcpb from ReleasesThat 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
| 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.
| 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 |
| 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 |
.mcpb packaging, Prometheus metrics, optional DockerTry 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.
| 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
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.
BLENDER_EXECUTABLEMIT — FlowEngineer sandraschi. Free for personal and commercial use.
Sign in to join the discussion.
No comments yet. Be the first to say what this is good for.
High-performance code intelligence MCP server. Indexes codebases into a persistent knowledge graph — average repo in milliseconds. 158 languages, sub-ms queries, 99% fewer tokens. Single static binary, zero dependencies.
Universal provider proxy for OpenAI Codex & Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code
Git-native persistent memory for AI coding agents. Implements Google OKF v0.2 with sub-300µs in-memory BM25 search, embedded MCP server, and progressive disclosure. Slashes token bloat by 80% with zero external databases or dependencies. Built in pure Go.
Local-first code intelligence graph for MCP and CLI. Builds a persistent map of your codebase so AI coding tools read only what matters, with benchmarked context reductions on reviews and large-repo workflows.
Stop your AI from making things up — it proposes, deterministic tools decide, every claim checked against ground truth with evidence. Grounded facts and context survive resets. Reverse engineering is the proving ground. MCP server + CLI.
20 MB lightweight cross-platform database client for 90+ databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Docker. | 轻量级跨平台数据库管理工具，支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、达梦等 90+ 数据库，提供桌面端、Docker、CLI、内置 AI 助手和 MCP Server。