*formerly `blender-mcp` — the PyPI package is now [`mcp-for-blender`](https://pypi.org/project/mcp-for-blender/).* *Existing setups keep working; no config change is required. [Read more](https://github.com/ahujasid/mcp-for-blender/issues/366)* **Disclaimer:** This is a third-party integration and not made by Blender Prompt-assisted 3D modeling, scene creation, and manipulation — driven by AI. [](https://pepy.tech/projects/blender-mcp) [](https://discord.gg/SNqPn4TcKQ) [](https://mcp-for-blender.com/) [](https://github.com/sponsors/ahujasid) [](https://pypi.org/project/mcp-for-blender/) [](LICENSE)
**Supporters** [CodeRabbit](https://www.coderabbit.ai/) [Guillermo Rauch](https://github.com/rauchg) **All supporters:** [Support this project](https://github.com/sponsors/ahujasid)

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)

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:

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.

# 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"

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

claude mcp add blender uvx mcp-for-blender

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

uvx mcp-for-blender install-addon

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

Premium

Generate AI 3D models (Meshy, Hunyuan3D, Tripo, Hyper3D Rodin) straight into Blender without bringing your own API keys. More details

Components

The system consists of two main components:

1. Blender Addon (addon.py) — a Blender addon that creates a socket server within Blender to receive and execute commands
2. 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)
irm https://www.mcp-for-blender.com/install.ps1 | iex

Already have uv? Run uvx mcp-for-blender setup instead. On Windows, winget install --id=astral-sh.uv -e installs uv without running a script. 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

brew install uv

winget install --id=astral-sh.uv -e

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

$localBin = "$env:USERPROFILE\.local\bin"
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", "$userPath;$localBin", "User")

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

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:

```json { "mcpServers": { "blender": { "command": "uvx", "args": ["--python", "3.11", "mcp-for-blend