Blender MCP: Control Blender With Claude and Other AI Assistants

Official vs community Blender MCP

	Official MCP Server (Blender Lab)	MCP for Blender (community)
Made by	Blender Lab, part of the Blender Foundation	Siddharth Ahuja and contributors
Old name	None	blender-mcp, renamed in September 2026
Current version	1.0.3 (September 2026)	2.1.0 (September 2026)
Blender needed	5.1 or newer	3.0 or newer
License	GPL-3.0	MIT
Tools	Scene summaries, docs lookup, screenshots, rendering, running code	Scene info, running code, asset libraries, AI model generation, export
Claude connector	Yes, this is the one behind it	No, set up by hand
Default connection	localhost, port 9876	localhost, port 9876

Both use port 9876 by default. Run only one of them at a time, or change the port on one.

Set up the official Blender MCP server with Claude

Anthropic launched a Blender connector for Claude on April 28, 2026. The Blender developers built the server behind it.

1. Install Blender 5.1 or newer.
2. In Claude Desktop, open Customize, then Connectors. Search for Blender and click Add. Claude Desktop is needed because Blender must run on the same computer.
3. Open the MCP Server page on blender.org. Drag the add-on link into Blender. The first drag adds the Blender Lab extensions repository. The second drag installs the add-on.
4. In Blender, open the add-on’s preferences and start the server.
5. In Claude, ask a simple question, like “What objects are in my Blender scene?”

For other assistants, the official server comes as an .mcpb bundle, or you can run it from its source code with the uv tool.

Set up MCP for Blender (the community version)

You need Blender 3.0 or newer, Python 3.10 or newer, and the uv package manager. Install uv with its official installer.

1. Install the Blender add-on by running this in a terminal:

uvx mcp-for-blender install-addon

2. In Blender, go to Edit, Preferences, Add-ons and turn on Interface: MCP for Blender.
3. In the 3D viewport, press N, open the MCP for Blender tab and click Start MCP Server.
4. Connect your assistant. For Claude Desktop, open Settings, then Developer, then Edit Config, and add:

{
  "mcpServers": {
    "blender": { "command": "uvx", "args": ["mcp-for-blender"] }
  }
}

For Claude Code, run:

claude mcp add blender uvx mcp-for-blender

For Codex, run:

codex mcp add blender -- uvx mcp-for-blender

For Cursor, put the same JSON as Claude Desktop in Settings, then MCP, or in a .cursor/mcp.json file in your project. On Windows, Cursor needs "command": "cmd" and "args": ["/c", "uvx", "mcp-for-blender"].

Old setups that use uvx blender-mcp still work. The old name now points to the new package.

Stay safe with Blender MCP

Both servers let an AI run any Python code inside Blender. That is what makes them useful, and also what makes them risky.

• Save your work first. The community README says so in capital letters.
• Read what the assistant plans to run, especially commands that delete, move or send files.
• Keep the connection on your own computer. The community add-on’s connection has no password or encryption. Anyone who can reach that port can run code in your Blender.
• Use a spare machine for sensitive work. The official page warns there are no guards to stop data from being deleted or sent elsewhere, and suggests a virtual machine.
• Try safe mode. The community version has one. Set BLENDER_MCP_SAFE_MODE=1 to block file access, network access and other risky code.
• Know about telemetry. The community version sends an anonymous usage record by default. Set DISABLE_TELEMETRY=true to turn it off.

Prompts to try

• “List every object in the scene with its polygon count, biggest first.”
• “Rename all meshes to match their material names.”
• “Add a three-point light setup around the selected object.”
• “Set up a turntable camera that circles the model in 120 frames.”
• “Find objects with no UV map and tell me which ones.”
• “Decimate the selected mesh to 20,000 triangles and show me the result.”

Start small, check the result, then ask for the next step.

Fix common Blender MCP problems

• spawn uvx ENOENT or “uvx not found”. Your app cannot find uvx. Use the full path to uvx in the config.
• The assistant cannot connect. Make sure the server is started in Blender, and that only one Blender MCP server is using port 9876.
• It worked in one app, then stopped in another. Run the server from one assistant at a time.
• The official add-on will not install. Check that you have Blender 5.1 or newer.

Blender MCP vs a 3D generation API

Blender MCP drives Blender. It is great for scene work, clean-up and automation. It does not rig or animate a new creature by itself. The community version can call outside services to make a static model, but you still need to rig and animate it.

Bake3D has its own MCP server with 14 tools. An assistant can upload an image, generate a textured model, rig it, create a described motion and export an animated GLB or FBX. You need a Pro or Studio API key. The two work well together: make the character with Bake3D, then import the GLB into Blender and let Blender MCP set up the scene.

See the Bake3D MCP workflow guide for setup, and import a rigged GLB into Blender for the Blender side.