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:

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