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

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

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

Fleet Crossconnects (Companions)

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

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

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.