Blender MCP: Seamless Integration of Blender with Claude AI

Blender MCP (Blender Model Context Protocol) is a nice tool that connects Blender to Claude AI, allowing AI-driven 3D modeling, scene creation, and object manipulation. This integration makes 3D design faster, more intuitive, and highly interactive.

Why Use Blender MCP?

• AI-powered modeling: Direct interaction with Claude AI for instant 3D modifications.
• Seamless asset management: Access Poly Haven and Hyper3D Rodin for quick model generation.
• Advanced material control: Modify object textures and materials effortlessly.
• Script execution: Run Python scripts directly within Blender.

Key Features

• Two-way communication between Blender and Claude AI
• Object creation, deletion, and transformation
• Material and texture application
• Scene inspection and real-time information retrieval
• AI-generated models via Hyper3D Rodin

Installation Guide

Prerequisites

To install Blender MCP, ensure you have:

• Blender 3.0+
• Python 3.10+
• uv package manager (Essential for running MCP)

Installing UV

For Mac:

brew install uv

For Windows:

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

Then, add to the system path:

set Path=C:\Users\nntra\.local\bin;%Path%

Full installation guide

⚠️ Do not proceed before installing UV

Setting Up MCP in Claude AI

1. Open Claude AI Desktop
2. Navigate to Settings > Developer > Edit Config
3. Add the following to claude_desktop_config.json:

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

Installing Blender Addon

1. Download the addon.py file
2. Open Blender
3. Navigate to Edit > Preferences > Add-ons
4. Click Install... and select addon.py
5. Enable the addon (Checkbox: "Interface: Blender MCP")

How to Use Blender MCP

Connecting to Claude AI

1. Open Blender and press N to access the 3D View Sidebar
2. Navigate to the BlenderMCP tab
3. Enable Poly Haven API (Optional)
4. Click "Connect to Claude"
5. Ensure the MCP Server is running

Example Commands

You can now interact with Blender through Claude AI by using commands like:

• Create a 3D scene: "Generate a dungeon scene with a dragon guarding gold"

Demo video

• Modify textures: "Make this car red and metallic"
• Use Poly Haven assets: "Create a beach scene using HDRIs and rock models from Poly Haven"

Demo video

• AI-generated models: "Generate a 3D garden gnome using Hyper3D Rodin"
• Adjust camera: "Set up isometric camera view"
• Lighting setup: "Adjust lighting to a studio environment"

Using MCP with Cursor Integration

1. Open Cursor Settings > MCP
2. Paste the command:

uvx blender-mcp

Cursor setup guide video]

⚠️ Run MCP server on either Cursor or Claude, NOT both

Troubleshooting & FAQs

Common Issues & Fixes

1. Connection Issues: Ensure the Blender Addon Server is running and correctly configured on Claude.
2. Timeout Errors: Break complex requests into smaller commands.
3. Poly Haven API Issues: Refresh API settings if assets fail to load.
4. General Fix: Restart Blender and Claude AI.

Security Considerations

• Python Execution Risks: The execute_blender_code function allows arbitrary code execution. Always save work before using it.
• Large Asset Downloads: Disable Poly Haven integration if not needed.
• Complex Commands: Break large operations into smaller steps for efficiency.

Contributing & Development

Blender MCP is an open-source project. Contributions are welcome! Submit a Pull Request or report issues on the GitHub repository: @blender-mcp

Final Thoughts

Blender MCP is a game-changer for 3D artists, allowing AI-assisted modeling, asset management, and interactive scene creation. By integrating Claude AI with Blender, this tool accelerates workflows and brings creative visions to life effortlessly.