Blender MCP setup guide (2026): connect Claude, Codex or Cursor to Blender

Blender MCP is the add-on behind the viral "AI built this whole scene in Blender" clips. Now called MCP for Blender (formerly blender-mcp), it connects any MCP-capable AI app to a live Blender session. The model writes Blender Python, imports assets, generates 3D models and looks at the viewport to check its own work. Free, MIT-licensed, ~30.6k GitHub stars when we checked on Oct 13, 2026. It's a community project, not made by the Blender Foundation.

Some links are affiliate links; CRT Forge may earn a commission at no extra cost to you. Affiliate disclosure.

Option A: one-command setup

The official installer finds your MCP clients (Claude Desktop, Claude Code, Codex, Cursor, VS Code, Windsurf, OpenCode, Antigravity), adds a blender entry, backs up each config as .bak, then installs and enables the Blender add-on. Read any script before you pipe it into a shell.

# macOS / Linux
curl -LsSf https://www.mcp-for-blender.com/install.sh | sh

# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://www.mcp-for-blender.com/install.ps1 | iex"

# already have uv?
uvx mcp-for-blender setup

Then fully quit and reopen your AI app (on Windows, quit it from the system tray), open Blender, and ask it to build something.

Option B: manual setup

1. Install uv

Use the official installer: brew install uv on macOS, or the scripts on docs.astral.sh/uv. The README warns against pip install uv.

2. Add the server to your client

Claude Desktop (Settings → Developer → Edit Config) and Cursor on macOS (Settings → MCP, or .cursor/mcp.json in a project):

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

Cursor on Windows:

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

Claude Code and Codex CLI:

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

3. Install the Blender add-on

uvx mcp-for-blender install-addon

In Blender: Edit → Preferences → Add-ons, enable Interface: MCP for Blender. Press N in the 3D viewport, open the MCP for Blender tab and click Start MCP Server if it isn't running.

Run only one MCP server instance (for example Cursor or Claude Desktop, not both).

What the AI can do: the nine tools

A game-dev workflow that actually works

1. Block out with code. Ask for the level layout, collision-friendly primitives and named collections first. Small steps beat one giant prompt (the README's own timeout advice).
2. Light and texture with Poly Haven. Tick Poly Haven in the sidebar (no key needed). Its assets are CC0.
3. Fill with low-poly props from Poly Pizza. Needs a free API key. The README says about 69% of its catalogue is CC-BY, which requires credit, so filter licence="CC0" if you don't want to track attribution.
4. Generate hero assets with generate_3d (Tripo, Rodin or Hunyuan3D), or bring them in from Meshy, Tripo or Rodin.
5. Rig and animate. Ask for named bones and clips (Idle, Walk, Run) up front, then export to your engine. Pair it with Unity MCP or godot-ai so the same agent wires the game.

Seen on X: the project's creator posted a how-to-rig thread (99 likes when we checked), and @rewind02 shared a cozy fishing game workflow built with Opus 5.5, Blender MCP and Unity MCP (71 likes). More in games built with coding agents.

Safety, safe mode and telemetry

• execute_blender_code runs arbitrary Python. Save first.
• The add-on socket (default localhost:9876) has no authentication or encryption. Keep it local, or use an SSH tunnel.
• Safe mode: set BLENDER_MCP_SAFE_MODE=1 to block file, network and process access while normal modeling, rendering and import/export keep working.
• Telemetry: content collection is opt-in. A minimal anonymous usage record is on by default; set DISABLE_TELEMETRY=true to switch it off.

Troubleshooting

Related: agent-built games, AI 3D tool comparison, GPU clouds for open-source 3D, AI mods & mashups.

Same agent, other engines: Unity MCP and Godot AI.

Once MCP for Blender is running, the next step is usually generation: how to pull Meshy models into Blender through MCP (text or image to GLB, remesh for a game budget, then export).

FAQ

What is Blender MCP?

MCP for Blender (formerly blender-mcp) is a free, MIT-licensed community add-on plus MCP server that lets an LLM like Claude, Codex or Cursor's agent control Blender: create and edit objects, apply materials, run Blender Python, pull assets and check its own work from the viewport. It isn't made by the Blender Foundation.

Is blender-mcp the same as mcp-for-blender?

Yes. The repo is now github.com/ahujasid/mcp-for-blender and the PyPI package is mcp-for-blender. The README says existing setups that run uvx blender-mcp keep working, but new installs should use mcp-for-blender. The latest PyPI release we saw on Oct 13, 2026 is 2.1.9 (uploaded Oct 6, 2026).

What do I need to install Blender MCP?

Blender 3.0 or newer, Python 3.10 or newer, and the uv package manager from its official installer (not pip install uv). Then add the server to your MCP client and enable the Interface: MCP for Blender add-on.

How do I fix 'spawn uvx ENOENT'?

GUI apps don't inherit your terminal PATH. Use the full path to uvx (find it with which uvx or where uvx) as the command, or on Windows use cmd /c uvx mcp-for-blender. Then fully quit and relaunch the client.

Is Blender MCP safe?

Treat it like giving the AI a Python console. execute_blender_code can run arbitrary code, and the add-on's socket (port 9876 by default) has no authentication, so keep it on localhost and save your work first. Set BLENDER_MCP_SAFE_MODE=1 to block risky code like file, network or process access.

Can I turn off Blender MCP telemetry?

Content telemetry is opt-in. A minimal anonymous usage record is sent by default; set DISABLE_TELEMETRY=true in the environment or MCP config to turn it off completely.