README

formerly blender-mcp — the PyPI package is now mcp-for-blender.
Existing setups keep working; no config change is required. Read more

Disclaimer: This is a third-party integration and not made by Blender

Prompt-assisted 3D modeling, scene creation, and manipulation — driven by AI.








 



Supporters

CodeRabbit
Guillermo Rauch

All supporters: Support this project



---

 Quickstart

 Note: the PyPI package blender-mcp is now mcp-for-blender. Existing setups
 keep working — uvx blender-mcp still runs the server and no config change is
 required. New installs should use mcp-for-blender.
 What changed and why

One command sets up your AI apps and the Blender addon:

macOS / Linux

bash
curl -LsSf https://www.mcp-for-blender.com/install.sh | sh


Windows (PowerShell)

powershell
irm https://www.mcp-for-blender.com/install.ps1 | iex


From Command Prompt instead: powershell -c "irm https://www.mcp-for-blender.com/install.ps1 | iex"

Prefer not to run a script, or Windows Defender blocked it? Install uv with winget, open a new terminal, then run setup:

powershell
winget install --id=astral-sh.uv -e
uvx mcp-for-blender setup


Already have uv? Run uvx mcp-for-blender setup instead.

It installs uv if needed, finds the MCP clients on your machine (Claude Desktop, Claude Code, Codex, Cursor, VS Code, Devin Desktop/Windsurf, OpenCode, Antigravity), and lets you pick which to set up. Then it installs the Blender addon and enables it. Your existing config is kept: it only adds a blender entry and saves a .bak of each file it changes.

Then fully quit and reopen your AI app (on Windows, quit it from the system tray), open Blender, and ask it to build something. The addon starts its server when Blender opens.



Manual setup, in case the automatic setup doesn't work

Three steps: install uv, point your MCP client at the server, install the Blender addon.

1. Install uv

bash
 macOS
brew install uv

 Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

 Windows
winget install --id=astral-sh.uv -e
 or, with uv's installer
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"


 Warning: Do not proceed before installing uv. Use the official installer — not pip install uv.

2. Add the MCP server to your client


Claude Desktop — Settings → Developer → Edit Config

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




Claude Code

bash
claude mcp add blender uvx mcp-for-blender




Codex

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




Cursor / VS Code / OpenCode / Antigravity

See MCP Client Setup below for per-client instructions and one-click install buttons.


3. Install the Blender addon

bash
uvx mcp-for-blender install-addon


Then in Blender: Edit → Preferences → Add-ons → enable Interface: MCP for Blender.

4. Connect

The addon starts its server when Blender opens. To check, press N in the 3D viewport → open the MCP for Blen