blender mcpmcp serversmodel context protocolblender mcp servers

BlenderMCP: Revolutionizing 3D Modeling with AI Integration

March 24, 2025
6 min read

In the rapidly evolving landscape of 3D design and modeling, the integration of artificial intelligence has opened new frontiers for creators. BlenderMCP stands at the forefront of this revolution, bridging the gap between natural language processing and 3D modeling capabilities. This innovative tool connects Blender, the industry-leading open-source 3D creation suite, with Claude AI through the Model Context Protocol (MCP), enabling users to control Blender using conversational prompts.

What is BlenderMCP?

BlenderMCP is a groundbreaking integration that establishes a two-way communication channel between Claude AI and Blender. This connection allows users to create, modify, and manipulate 3D objects, materials, and entire scenes using natural language instructions. Whether you're a seasoned 3D artist looking to streamline your workflow or a beginner seeking an intuitive entry point into the world of 3D modeling, BlenderMCP offers a powerful new approach to creation.

The system comprises two main components: a Blender addon that creates a socket server within the application to receive and execute commands, and an MCP server that implements the Model Context Protocol and connects to the Blender addon. This architecture ensures smooth communication between Claude AI and Blender, translating natural language instructions into precise 3D modeling operations.

Detailed Installation Guide

Before diving into the world of AI-assisted 3D modeling with BlenderMCP, you'll need to properly set up the environment. Follow these step-by-step instructions to get started:

Prerequisites

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

Step 1: Install the uv Package Manager

The uv package manager is essential for running BlenderMCP. Installation methods vary by operating system:

For Mac users:

brew install uv

For Windows users:

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

After installation on Windows, add uv to your PATH:

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

Step 2: Configure Claude for Desktop Integration

  1. Open Claude desktop application
  2. Navigate to Settings > Developer > Edit Config
  3. Open the claude_desktop_config.json file
  4. Add the following configuration:
{
    "mcpServers": {
        "blender": {
            "command": "uvx",
            "args": [
                "blender-mcp"
            ]
        }
    }
}

Step 3: Cursor Integration (Alternative Method)

If you prefer using Cursor instead of Claude Desktop:

  1. Go to Cursor Settings > MCP
  2. Paste this command:
uvx blender-mcp

For Windows Cursor users:

  1. Go to Settings > MCP > Add Server
  2. Add a new server with these settings:
{
    "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.

Step 4: Install the Blender Addon

  1. Download the addon.py file from the BlenderMCP repository
  2. Open Blender
  3. Go 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"

Step 5: Connect BlenderMCP with Blender

  1. In Blender, open the 3D View sidebar (press N if not visible)
  2. Find the "BlenderMCP" tab
  3. Enable the Poly Haven checkbox if you want to use assets from their API (optional)
  4. Click "Connect to Claude"
  5. Ensure the MCP server is running

Once these steps are completed, you'll see a hammer icon with tools for BlenderMCP in your interface, indicating that the connection is established and ready to use.

Troubleshooting Common Installation Issues

  • Connection problems: Verify that both the Blender addon server and the MCP server are properly configured. Do not run the uvx command manually in the terminal.
  • First command not working: Sometimes the initial command might not go through, but subsequent ones will work normally.
  • Timeout errors: Try simplifying your requests or breaking them into smaller steps.
  • Poly Haven integration issues: The integration can occasionally be inconsistent.
  • Persistent connection errors: Try restarting both Claude and the Blender server.

Key Features and Capabilities

BlenderMCP boasts an impressive array of features that transform the 3D modeling experience:

  • Two-way communication: The socket-based server enables seamless interaction between Claude AI and Blender.
  • Object manipulation: Users can create, modify, and delete 3D objects with simple verbal instructions.
  • Material control: Apply and modify materials and colors to objects without navigating complex menus.
  • Scene inspection: Obtain detailed information about the current Blender scene to inform further modifications.
  • Code execution: Run arbitrary Python code in Blender directly from Claude, unlocking unlimited customization potential.
  • Poly Haven integration: Access a vast library of high-quality 3D assets, including models, textures, and HDRI environments.
  • Hyper3D Rodin support: Generate AI-powered 3D models through natural language prompts.

Practical Applications

The versatility of BlenderMCP makes it suitable for a wide range of applications:

  1. Rapid prototyping: Quickly iterate on 3D concepts using natural language commands.
  2. Educational tool: Lower the learning curve for newcomers to 3D modeling.
  3. Accessibility enhancement: Make 3D creation more accessible to users with disabilities.
  4. Production efficiency: Streamline repetitive tasks in professional 3D workflows.
  5. Creative exploration: Experiment with complex scene setups through intuitive verbal instructions.

Example Commands

The power of BlenderMCP becomes apparent through these example commands:

  • "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 like rocks and vegetation from Poly Haven"
  • "Generate a 3D model of a garden gnome through Hyper3D"
  • "Make this car red and metallic"
  • "Point the camera at the scene, and make it isometric"

Future Implications

As AI technology continues to evolve, tools like BlenderMCP represent the beginning of a fundamental shift in how we interact with creative software. The ability to translate natural language instructions into complex 3D operations not only enhances productivity but also democratizes access to advanced creation tools. As this technology matures, we can expect even more sophisticated integration between AI and 3D modeling software, potentially transforming industries from game development and film production to architecture and product design.

Community and Support

BlenderMCP benefits from an active community of users and developers who contribute to its ongoing development and refinement. Users can join the dedicated Discord channel to share feedback, get inspiration, and build upon the Model Context Protocol. This collaborative approach ensures that BlenderMCP continues to evolve based on real-world user needs and creative applications.

Conclusion

BlenderMCP represents a significant leap forward in the integration of AI with 3D modeling tools. By enabling natural language control of Blender, it offers a more intuitive, efficient, and accessible approach to 3D creation. As this technology continues to evolve, it promises to reshape how we think about and interact with 3D modeling software, opening new possibilities for creators across various disciplines.

GitHub: https://github.com/ahujasid/blender-mcp/tree/main