BlenderMCP

BlenderMCP - Blender Model Context Protocol Integration

BlenderMCP connects Blender to Claude AI and cursor through the Model Context Protocol (MCP), allowing Claude and cursor to directly interact with and control Blender. This integration enables prompt assisted 3D modeling, scene creation, and manipulation.

- Added support for Poly Haven assets through their API
- Added support to prompt 3D models using Hyper3D Rodin
- For newcomers, you can go straight to Installation. For existing users, see the points below
- Download the latest addon.py file and replace the older one, then add it to Blender
- Delete the MCP server from Claude and add it back again, and you should be good to go!

- Two-way communication: Connect Claude AI to Blender through a socket-based server
- Object manipulation: Create, modify, and delete 3D objects in Blender
- Material control: Apply and modify materials and colors
- Scene inspection: Get detailed information about the current Blender scene
- Code execution: Run arbitrary Python code in Blender from Claude

The system consists of two main components:
- Blender Addon (addon.py): A Blender addon that creates a socket server within Blender to receive and execute commands
- MCP Server (src/blender_mcp/server.py): A Python server that implements the Model Context Protocol and connects to the Blender addon

- Blender 3.0 or newer
- Python 3.10 or newer
- uv package manager:

If you're on Mac, please install uv as

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

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

Otherwise installation instructions are on their website:Install uv

To install Blender Integration Server for Claude Desktop automatically viaSmithery:

npx -y @smithery/cli install @Gorav22/blender-mcp --client claude

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

For Mac users, go to Settings > MCP and paste the following

- To use as a global server, use "add new global MCP server" button and paste
- To use as a project specific server, create.cursor/mcp.jsonin the root of the project and paste

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

For Windows users, go to Settings > MCP > Add Server, add a new server with the following settings:

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

⚠️ Only run one instance of the MCP server (either on Cursor or Claude Desktop), not both
- Download theaddon.pyfile from this repo
- Open Blender
- Go to Edit > Preferences > Add-ons
- Click "Install..." and select theaddon.pyfile
- Enable the addon by checking the box next to "Interface: Blender MCP"
- In Blender, go to the 3D View sidebar (press N if not visible)
- Find the "BlenderMCP" tab
- Turn on the Poly Haven checkbox if you want assets from their API (optional)
- Click "Connect to Claude"
- Make sure the MCP server is running in your terminal

Once the config file has been set on Claude, and the addon is running on Blender, you will see a hammer icon with tools for the Blender MCP.

- Get scene and object information
- Create, delete and modify shapes
- Apply or create materials for objects
- Execute any Python code in Blender
- Download the right models, assets and HDRIs throughPoly Haven
- AI generated 3D models through[Hyper3D Rodin

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

- Connection issues: Make sure the Blender addon server is running, and the MCP server is configured on Claude, DO NOT run the uvx command in the terminal. Sometimes, the first command won't go through but after that it starts working.
- Timeout errors: Try simplifying your requests or breaking them into smaller steps
- Poly Haven integration: Claude is sometimes erratic with its behaviour
- Have you tried turning it off and on again?: If you're still having connection errors, try restarting both Claude and the Blender server

The system uses a simple JSON-based protocol over TCP sockets:

- Commandsare sent as JSON objects with atypeand optionalparams
- Responsesare JSON objects with astatusandresultormessage