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**
 [code] 
**Windows** (PowerShell)
 [code] 
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:
 [code] 
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**
 [code] 
> **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 
 [code] 
 Claude Code 
 [code] 
 Codex 
 [code] 
 Cursor / VS Code / OpenCode / Antigravity 
See MCP Client Setup below for per-client instructions and one-click install buttons.
**3. Install the Blender addon**
 [code] 
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