Blender MCP connects Claude to Blender so you can build and edit 3D scenes by prompt — create objects, apply materials, run Python in the viewport and more. The widely-used blender-mcp (ahujasid) had a breakout moment in 2026. Here's the setup.
How it works
Two parts: a Blender addon (the in-app bridge) and a small MCP server (run via uvx) that your client talks to. The server relays commands to the addon, which executes them in Blender.
Step 1 — install the Blender addon
Download addon.py from the blender-mcp repo. In Blender: Edit → Preferences → Add-ons → Install, select addon.py, enable it. In the 3D viewport sidebar (press N), open the BlenderMCP tab and click Connect.
Step 2 — configure the client
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["blender-mcp"]
}
}
}
Requires Python 3.10+ with uv. Don't run uvx blender-mcp in a terminal yourself — let the client launch it. Restart the client; see MCP config file location.
Step 3 — verify
Keep Blender open with the addon connected. Ask: "Create a low-poly tree with a brown trunk and green foliage." If it appears in the scene, you're connected.
Common problems
- Not connecting — Blender must be open and you must click Connect in the BlenderMCP sidebar tab.
uvx: command not found— installuv.- Commands error — the addon runs Python in Blender; complex requests can fail. Work in small steps and save often.
- No tools in client — see Cursor MCP not working.
Safety
Blender MCP can run arbitrary Python inside Blender — only connect a server you trust and save your work before agent sessions. See how to vet an MCP server.
Going further
Blender pairs with a filesystem server (save renders/assets). Browse the design category or curated loadouts. Building 3D-tool servers? Submit yours.