Blender Integration MCP Server

Overview

BlenderMCP creates a bridge between AI assistants and Blender 3D software through the Model Context Protocol. This integration allows AI to directly interact with Blender, enabling prompt-assisted 3D modeling, scene creation, and manipulation.

Installation

Prerequisites

Before installing BlenderMCP, ensure you have:

• Blender 3.0 or newer
• Python 3.10 or newer
• The uv package manager

Install uv based on your operating system:

Mac:

brew install uv

Windows:

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

Then add it to your path:

set Path=C:\Users\[username]\.local\bin;%Path%

For other systems, follow the installation instructions at the uv documentation.

Blender Addon Installation

1. Download the addon.py file from the BlenderMCP repository
2. Open Blender
3. Navigate to Edit > Preferences > Add-ons
4. Click "Install..." and select the downloaded addon.py file
5. Enable the addon by checking the box next to "Interface: Blender MCP"

AI Assistant Configuration

For Claude Desktop:

1. Go to Claude > Settings > Developer > Edit Config
2. Add the BlenderMCP configuration to your claude_desktop_config.json:

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

For Cursor:

Mac users:

1. Go to Settings > MCP
2. To use as a global server, click "add new global MCP server" and paste the configuration
3. For project-specific use, create .cursor/mcp.json in your project root with the configuration

Windows users:

1. Go to Settings > MCP > Add Server
2. Add a new server with the following configuration:

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

Important: Only run one instance of the MCP server (either on Cursor or Claude Desktop), not both.

Usage

Starting the Connection

1. In Blender, open the 3D View sidebar (press N if not visible)
2. Find the "BlenderMCP" tab
3. Optionally enable the Poly Haven checkbox if you want to use assets from their API
4. Click "Connect to Claude"

Working with AI

Once connected, you'll see a hammer icon in your AI assistant interface with tools for the Blender MCP. You can now ask the AI to:

• Get scene and object information
• Create, delete, and modify 3D shapes
• Apply or create materials for objects
• Execute Python code in Blender
• Download models, assets, and HDRIs through Poly Haven
• Generate 3D models using Hyper3D Rodin

Example Prompts

Try these example prompts with your AI assistant:

• "Create a low poly scene in a dungeon, with a dragon guarding a pot of gold"
• "Create a beach vibe using HDRIs, textures, and models from Poly Haven"
• "Generate a 3D model of a garden gnome through Hyper3D"
• "Make this car red and metallic"
• "Create a sphere and place it above the cube"
• "Make the lighting like a studio"
• "Point the camera at the scene, and make it isometric"

You can also provide reference images and ask the AI to create a Blender scene based on them.

Hyper3D Integration

Hyper3D's free trial key allows you to generate a limited number of models per day. If you reach the daily limit, you can either wait for the next day's reset or obtain your own key from hyper3d.ai and fal.ai.

Troubleshooting

• Connection issues: Ensure the Blender addon server is running and the MCP server is properly configured. Do not manually run the uvx command in the terminal.
• First command not working: Sometimes the first command won't go through, but subsequent commands will work properly.
• Timeout errors: Try simplifying your requests or breaking them into smaller steps.
• Poly Haven integration: The AI's behavior with Poly Haven assets may sometimes be inconsistent.
• General issues: If you encounter problems, try restarting both Blender and your AI assistant.

Community

For feedback, inspiration, and collaboration, join the BlenderMCP Discord community.