Blender MCP

Connect Blender to any LLM

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

Website · Full Tutorial · Discord · Releases · Sponsor

Supporters

CodeRabbit Kevin Guanche Darias

All supporters: Support this project

---

Quickstart

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

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

claude mcp add blender uvx blender-mcp

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

3. Install the Blender addon

uvx blender-mcp install-addon

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

4. Connect

In Blender's 3D viewport, press N → open the BlenderMCP tab → click Start MCP Server. 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
• Components
• Installation
  • Prerequisites
  • Make your client find uvx
  • Pin the Python version
  • Install without uv
  • Environment Variables
• MCP Client Setup
  • Claude for Desktop
  • Cursor
  • Visual Studio Code
  • OpenCode
• 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

---

GitHub에서 전체 내용 보기