Blender MCP Server

How to use

You connect Claude to Blender through a local MCP server and exchange commands over a socket-based channel. Start Blender with the blender-mcp addon active, ensure the MCP server is running, and configure Claude to point at that server. Once connected, you can instruct Claude to inspect your scene, create or modify objects, apply materials, execute Python code in Blender, and download assets from Poly Haven or generate models via Hyper3D Rodin.

How to install

Prerequisites you need before installing the Blender MCP server are Blender 3.0 or newer and Python 3.10 or newer. You also need to install the UV package manager to enable the MCP communication flow.

Install UV if you have not already done so. On macOS, run: brew install uv . On Windows, run the following PowerShell command and then add the path to your environment:

powershell -c "irm https://astral.sh/uv/install.ps1 | iex" 
```
```
set Path=C:\Users\<YourUser>\.local\bin;%Path%

How to install continued

Install the Blender addon by placing the addon.py file in Blender and enabling it.

Steps to install the addon in Blender:

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

Configure Claude Desktop and Cursor integration

Prepare Claude Desktop to connect to the local MCP server by editing the claude_desktop_config.json and adding the Blender MCP server configuration.

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

Starting the connection

In Blender, open the 3D View sidebar, locate the BlenderMCP tab, and connect to Claude. Ensure the MCP server process is running in your terminal. This setup enables Claude to issue commands to Blender and receive results.

Tools and capabilities

Capabilities include getting scene/object information, creating, deleting and modifying shapes, applying or creating materials, executing Python code in Blender, and downloading assets from Poly Haven or generating models via Hyper3D Rodin.

Example usage patterns

Ask Claude to set up and visualize a scene quickly, for example: create a simple low-poly landscape with a rock and a tree, then adjust lighting and camera to form a cinematic shot. You can also request specific assets from Poly Haven or generate models through Hyper3D Rodin.

Hyper3D integration and limits

Hyper3D offers a trial key with a daily limit for model generation. If you reach the limit, wait for the daily reset or provide your own key to continue generating models.

Troubleshooting

If you encounter connection issues, ensure the Blender addon server is running and Claude is configured to connect to it. Do not run multiple MCP server instances simultaneously in different clients. If timeouts occur, simplify requests or split them into smaller steps.

If problems persist, restart both Claude and the Blender MCP server, and verify that the addon is enabled in Blender.

Security and safety notes

The execute_blender_code capability allows running arbitrary Python code in Blender. Use with caution in production environments and always save your work beforehand.

Technical details

Communication uses a simple JSON-based protocol over TCP sockets, with commands and responses exchanged as JSON objects containing status, results, and messages.

Get scene and object information

Query the current Blender scene to obtain details about objects, cameras, lights, materials, and scene properties.

Create, delete and modify shapes

Add new objects to the scene, remove existing ones, or modify their transformation, geometry, and properties.

Material handling

Apply, modify, or create materials and assign them to objects, including color and texture settings.

Execute Python code in Blender

Run arbitrary Python code within Blender to automate tasks, run scripts, or generate content dynamically.

Asset download and import

Download assets from Poly Haven and other integrations, and import them into the current Blender scene.

Hyper3D Rodin integration

Generate AI-created 3D models using Hyper3D Rodin and bring them into the scene.