Blender MCP

About

BlenderMCP connects Blender to an AI assistant over the Model Context Protocol, and it is two pieces rather than one: addon.py runs inside Blender and opens a socket server on port 9876 (BLENDER_HOST / BLENDER_PORT override it, so Blender can live on another machine), while the blender-mcp Python package is the MCP server your client launches and which relays commands into that socket. Blender must therefore be open with the 'Interface: Blender MCP' addon enabled and 'Connect to Claude' pressed in the BlenderMCP sidebar tab before any tool call can do anything — that missing step accounts for most 'it connects but nothing happens' reports. Requirements are Blender 3.0+ and Python 3.10+, installed via uv's official installer (not `pip install uv`, which may not create the uvx command clients need). Capabilities: read the scene graph and take viewport screenshots, create/modify/delete objects, apply materials and colours, run arbitrary Python through execute_blender_code, download models, textures and HDRIs from Poly Haven, search and pull Sketchfab models, and generate models with Hyper3D Rodin or Hunyuan3D — asset keys live in the addon preferences or in BLENDERMCP_* environment variables. Note two current caveats: the upstream GitHub repository does not resolve (github.com/ahujasid/blender-mcp redirects to github.com/MCPBlender/blender-mcp, which returned 404 on 2026-08-10) although the PyPI package is still being released, and anonymous telemetry is on by default and disabled with DISABLE_TELEMETRY=true. It is a third-party integration by Siddharth Ahuja, not made by Blender.

Installation

uvx blender-mcp

Setting up BlenderMCP

1. 1.Install uv properly

   macOS: `brew install uv`. Windows: `powershell -c "irm https://astral.sh/uv/install.ps1 | iex"`, then add %USERPROFILE%\.local\bin to your user PATH and restart the client. Linux: `curl -LsSf https://astral.sh/uv/install.sh | sh`, then open a new shell. Do not proceed before uv works.

   shell

   brew install uv   # macOS

2. 2.Install and enable the Blender addon

   Download addon.py from the project, then in Blender: Edit → Preferences → Add-ons → Install…, select addon.py, and tick the box next to "Interface: Blender MCP". Note that the upstream GitHub repository currently does not resolve — github.com/ahujasid/blender-mcp redirects to github.com/MCPBlender/blender-mcp, which returns 404 as of this verification date — so blendermcp.org is the place to start looking for the addon file. The PyPI release is unaffected and current.

3. 3.Add the server to your client

   Claude Desktop: Settings → Developer → Edit Config. Claude Code: `claude mcp add blender uvx blender-mcp`. Cursor takes the same JSON globally or in .cursor/mcp.json. On Windows, wrap it: `"command": "cmd", "args": ["/c", "uvx", "blender-mcp"]`. Run only one instance of the MCP server — Cursor or Claude Desktop, not both.

   claude_desktop_config.json

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

4. 4.If the client cannot find uvx

   A GUI-launched client does not inherit your terminal PATH, so a bare `"command": "uvx"` can fail with `spawn uvx ENOENT` even though uvx works in a shell. Use the absolute path from `which uvx` / `where uvx` (e.g. /opt/homebrew/bin/uvx), then fully quit and relaunch the client — Cmd-Q on macOS, quit from the system tray on Windows.

5. 5.Pin Python if you have conda, pyenv or asdf

   uv picks the interpreter, and on machines with an auto-activated conda base it can pick one that fails to build dependencies. Pin 3.11 and prefer uv-managed interpreters. If a failed attempt keeps replaying after you fix it, clear the cache: `uv cache clean blender-mcp && uvx --refresh blender-mcp`.

   mcp config

   {
     "mcpServers": {
       "blender": {
         "command": "uvx",
         "args": ["--python", "3.11", "blender-mcp"],
         "env": { "UV_PYTHON_PREFERENCE": "only-managed" }
       }
     }
   }

6. 6.Start the connection inside Blender

   In the 3D View sidebar (press N), open the BlenderMCP tab, optionally tick Poly Haven to allow asset downloads, and click "Connect to Claude". Do not run the uvx command yourself in a terminal — the client starts it. Sometimes the first command does not go through and it works from the second onward.

What it can do, and the asset services behind it

Communication is a JSON protocol over TCP — commands carry a type and optional params, responses carry a status plus result or message. BLENDER_HOST (default localhost) and BLENDER_PORT (default 9876) let the MCP server talk to Blender on another machine.

What people use it for

Which one should you use?

Only run one MCP server against a single Blender instance — the addon exposes one socket.

Categories

Works With

Frequently Asked Questions