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.

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

Claude Desktop one-liner (downloads + runs the installer from the latest release):

irm https://github.com/sandraschi/blender-mcp/releases/latest/download/install.ps1 | iex

Other MCP clients (manual config via uvx):

{
  "mcpServers": {
    "blender-mcp": {
      "command": "uvx",
      "args": ["blender-mcp"],
      "env": { "BLENDER_EXECUTABLE": "C:\\Program Files\\Blender Foundation\\Blender 4.4\\blender.exe" }
    }
  }
}

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 Crossconnects (Companions)

blender-mcp works completely standalone. You can optionally connect it with companion servers in the sandraschi fleet to unlock extended features:

Companion Server	Feature Unlocked	Status	Setup
qcad-mcp	dxf-svg-exchange, 2d-cad-to-3d-scene	Optional	Install Guide
freecad-mcp	step-cad-import, mechanical-visualization	Optional	Install Guide
resonite-mcp	gltf-export-to-vr, avatar-mesh-pipeline	Optional	Install Guide
speech-mcp	task-completion-readout, render-completion-announcements	Optional	Install Guide

Self-Contained Companions: Fleet companions operate independently. Installing companions does not trigger transitive dependency chains.

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

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.