ahujasid/mcp-for-blender

MCP for Blender Connect Blender to any LLM 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 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? 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 # macOS brew install uv # Linux curl -LsSf https://astral.sh/uv/install.sh | sh # Windows powershell -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 { "mcpServers" : { "blender" : { "command" : " uvx " , "args" : [ " mcp-for-blender " ] } } } Claude Code claude mcp add blender uvx mcp-for-blender Codex 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 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 Blender tab (click Start MCP Server if it isn't running). That's it — ask Claude to build something. Note: Only run one instance of the MCP server (either Cursor or Claude Desktop), not both. Table of Contents Quickstart Features Premium Components Installation Automatic setup Prerequisites Make your client find uvx Pin the Python version Install without uv Run with Docker Environment Variables MCP Client Setup Claude for Desktop Codex Cursor Visual Studio Code OpenCode Antigravity Installing the Blender Addon Upgrading (existing users) Usage Starting the Connection Using with Claude Capabilities Example Commands Persistent API Credentials Troubleshooting Technical Details Limitations & Security Considerations Telemetry Control Feedback Contributing Disclaimer Star History Features Two-way communication Connect Claude AI to Blender through a socket-based server Object manipulation Create, modify, and delete 3D objects in Blender Material control Apply and modify materials and colors Visual verification Multi-angle, camera, wireframe, X-ray and animation-strip views, plus renders, so the AI checks its own work Code execution The AI writes Blender Python directly Asset & model generation Poly Haven assets, Sketchfab models, Poly Pizza low-poly models, and AI-generated 3D models via Tripo, Hyper3D Rodin and Hunyuan3D Premium Generate AI 3D models (Hunyuan3D, Tripo, Hyper3D Rodin) straight into Blender without bringing your own API keys. More details Components The system consists of two main components: Blender Addon ( addon.py ) — a Blender addon that creates a socket server within Blender to receive and execute commands MCP Server ( src/blender_mcp/server.py ) — a Python server that implements the Model Context Protocol and connects to the Blender addon Installation Automatic setup The quickest way is the one-line installer. It installs uv, configures your MCP clients, and installs and enables the Blender addon: # 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? Run uvx mcp-for-blender setup instead. See Quickstart for what it changes. The rest of this section covers manual setup. Prerequisites Blender 3.0 or newer Python 3.10 or newer uv package manager Installing uv, per platform macOS brew install uv Windows powershell - c " irm https://astral.sh/uv/install.ps1 | iex " Then add uv to the user path in Windows (you may need to restart Claude Desktop after): $localBin = " $ env: USERPROFILE \.local\bin " $userPath = [ Environment ]::GetEnvironmentVariable( " Path " , " User " ) [ Environment ]::SetEnvironmentVariable( " Path " , " $userPath ; $localBin " , " User " ) Linux curl -LsSf https://astral.sh/uv/install.sh | sh It lands in ~/.local/bin — open a new shell so it's on your PATH. Otherwise, installation instructions are on their website: Install uv On every OS, use uv's official installer above — not pip install uv , which may not create the uvx command and can hide uv inside an environment your client can't see. Warning: Do not proceed before installing uv. Make your client find uvx MCP clients started from a GUI (Claude Desktop, Cursor, VS Code from the Dock/Start menu) do not inherit your terminal's PATH, so a bare "command": "uvx" can fail with spawn uvx ENOENT even though uvx works in your terminal. If that happens: Find uvx's full path — which uvx (macOS/Linux) or where uvx (Windows) — and use it as "command" , e.g. /opt/homebrew/bin/uvx or C:\Users\<you>\.local\bin\uvx.exe . On Windows you can instead wrap it: "command": "cmd", "args": ["/c", "uvx", "mcp-for-blender"] . After any PATH or config change, fully quit and relaunch the client (Windows: quit from the system tray, not just the window; macOS: Cmd + Q ). Pin the Python version Avoid conda / pyenv / version conflicts. uv chooses which Python runs the server. On machines with conda (auto-activated base), pyenv, or asdf — or with a newer CPython release that some dependencies do not have wheels for yet — uv can grab an interpreter that makes installation fail. Pin Python 3.11 and prefer uv-managed interpreters to avoid using whatever is on your PATH: { "mcpServers" : { "blender" : { "command" : " uvx " , "args" : [ " --python " , " 3.11 " , " mcp-for-blender " ], "env" : { "UV_PYTHON_PREFERENCE" : " only-managed " } } } } --python 3.11 still satisfies this package's requires-python >=3.10 , and UV_PYTHON_PREFERENCE=only-managed keeps uv from selecting conda, pyenv, asdf, or system Python first. (The repo's .python-version is only a hint for contributors and does not affect uvx .) If a previous failed attempt keeps replaying after a fix, clear the cache: uv cache clean mcp-for-blender blender-mcp && uvx --refresh mcp-for-blender Install without uv On locked-down machines you can skip uvx entirely with pipx , then point your client at the installed command: pipx install mcp-for-blender pipx ensurepath # then restart your shell / client Use the resulting absolute path as "command" (find it with which mcp-for-blender / where mcp-for-blender ) and omit args . Run with Docker You can run the MCP server in a container instead of installing it. Blender itself still runs on your machine — the container only hosts the MCP server, which connects out to the Blender addon.