# blender-mcp: AI-Assisted 3D Modeling with Claude via MCP Server

> blender-mcp is an MCP Server that integrates Blender with Claude AI, enabling prompt-driven 3D modeling, scene creation, and object manipulation. It solves the challenge of AI-assisted design within Blender, leveraging Poly Haven assets and Hyper3D Rodin. Developers working with Blender and Claude will find this integration valuable for accelerating creative workflows.

**Published:** 2026-08-11T12:01:02.667+00:00

**Keywords:** blender-mcp,mcp-server,blender-ai,claude-integration,3d-modeling

# blender-mcp: AI-Assisted 3D Modeling with Claude via MCP

blender-mcp connects Blender to Claude AI through the Model Context Protocol (MCP), enabling developers to drive 3D modeling, scene creation, and object manipulation using natural language prompts. This integration facilitates direct AI control over Blender, supporting assets from Poly Haven and 3D model generation via Hyper3D Rodin.

## Wiring Blender to Claude with MCP

The core of blender-mcp is its two-way, socket-based communication between Claude AI and Blender. This setup allows Claude to send commands to Blender and retrieve detailed scene information. The project consists of two main components:

1.  **Blender Addon (`addon.py`)**: This Python script creates a socket server directly within Blender, listening for and executing commands received over the MCP connection.
2.  **MCP Server (`src/blender_mcp/server.py`)**: This component implements the Model Context Protocol, acting as the bridge between Claude AI and the Blender addon.

To integrate blender-mcp, you'll configure your Claude environment to point to this MCP server. For instance, with Claude for Desktop, you'd modify `claude_desktop_config.json`. Similarly, Cursor users can configure their MCP settings to run the blender-mcp server.

## Capabilities and Tools

Once connected, Claude gains a range of capabilities within Blender:

*   **Object Manipulation**: Create, modify, and delete 3D objects.
*   **Material Control**: Apply and modify materials and colors on objects.
*   **Scene Inspection**: Retrieve detailed information about the current Blender scene, including objects, their properties, and materials.
*   **Code Execution**: Run arbitrary Python code directly within Blender from Claude, enabling advanced customization and automation.
*   **Asset Integration**: Access and integrate assets from Poly Haven through their API.
*   **AI-Generated Models**: Prompt 3D models using Hyper3D Rodin for rapid prototyping and content generation.

These features are exposed as tools that Claude can invoke, allowing for a conversational approach to 3D design and scene assembly.

## Installation and Setup

Getting blender-mcp running requires a few prerequisites and steps:

### Prerequisites

*   Blender 3.0+
*   Python 3.10+
*   `uv` package manager (installable via `brew install uv` on Mac or PowerShell script on Windows)

### Installing the Blender Addon

1.  Download the `addon.py` file from the blender-mcp GitHub repository.
2.  In Blender, navigate to `Edit > Preferences > Add-ons`.
3.  Click "Install..." and select the downloaded `addon.py` file.
4.  Enable the addon by checking the box next to "Interface: Blender MCP".

After the addon is installed and enabled, you can start the connection within Blender and then configure your Claude client (e.g., Claude for Desktop or Cursor) to interact with the blender-mcp server.

## References

*   [blender-mcp on GitHub](https://github.com/ahujasid/blender-mcp)
*   [Model Context Protocol Documentation](https://modelcontextprotocol.io/introduction)
*   [blender-mcp on model-context-protocol.com](https://model-context-protocol.com/servers/)

## Related Repository

- [blender-ai-assisted-3d-modeling-tool](https://model-context-protocol.com/servers/blender-ai-assisted-3d-modeling-tool)

**Source:** https://model-context-protocol.com/blog/blender-mcp-ai-assisted-3d-modeling-with-claude-via-mcp-server-mcp-server-guide