BlenderMCP - Blender Model Context Protocol Integration MCP Server

How to use

Make sure the Blender MCP server is running and your MCP client (Claude or another MCP client) is configured to talk to it. In Blender, open the 3D View, access the side panel, and enable the Blender MCP tab. You can toggle optional asset sources like Poly Haven to download models, textures, and HDRIs directly into your scene. Use Claude to issue high-level prompts such as creating a scene, placing objects, adjusting lighting, or executing Python code inside Blender. The server exposes capabilities to inspect the scene, create, modify, or delete objects, apply materials, and run code, all through structured commands sent from your MCP client.

Practical workflows you can perform include: creating a basic scene from a prompt, refining object placements, updating materials or colors, fetching asset details, and running small script blocks to automate repetitive edits. For example, you can ask Claude to generate a low-poly dungeon scene, then adjust the lighting to studio quality, or generate a 3D model from Hyper3D Rodin and place it in the scene.

How to install

Prerequisites you need installed before starting are Blender 3.0 or newer, Python 3.10 or newer, and the uv package manager. If you are on macOS, install uv with brew. On Windows, install uv via the provided PowerShell script and update your PATH.

Install uv (examples shown). Do not proceed without UV. Then install and run the Blender MCP server alongside the Blender addon.

Environment variables for configuring the Blender connection (optional) are BLENDER_HOST and BLENDER_PORT. Use them to point the MCP server to the correct socket location.

Claude Desktop integration requires adding a configuration block that specifies how to start the MCP server from Claude. Use this config snippet in claude_desktop_config.json:

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

Additional setup for the MCP connection

If you use Cursor for MCP integration, add a project-wide or global server configuration to point to the blender-mcp server using uvx. The Windows setup typically runs the server through cmd with uvx blender-mcp. Ensure only one MCP server instance runs at a time.

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

Usage tips and start sequence

1) Start Blender and enable the Blender MCP addon. 2) Start the MCP server using the configured command in your MCP client (for example, uvx blender-mcp). 3) In Claude, ensure the MCP server is selected and connected. 4) In Blender, enable the Poly Haven checkbox (optional) to access external assets. 5) Use Claude prompts to build scenes, fetch objects, or run Python code inside Blender.

Hyper3D integration

Hyper3D integration allows you to generate 3D models within Claude and bring them into Blender. A free trial key is available for limited daily usage; you can obtain your own key from the Hyper3D provider if you need more capacity.

Troubleshooting

Connection issues usually mean the Blender addon server is not running or the MCP server is not configured in Claude. Do not run the uvx command in the terminal if Claude is also starting a server. If you encounter timeouts, try breaking requests into smaller steps. Restart both Claude and the Blender server if needed.

Security and best practices

The execute_blender_code capability lets you run arbitrary Python code in Blender. Use it with caution and always save your work before executing. If you do not want to fetch assets through Poly Haven, disable that option in Blender.

Tools and capabilities

BlenderMCP exposes a range of actions you can request from Claude, including obtaining scene information, creating/modifying/deleting objects, applying materials, and running Python code inside Blender. You can also fetch models, textures, and HDRIs via Poly Haven and generate objects through Hyper3D Rodin.

Examples of prompts you can use

Create a low-poly dungeon scene with a dragon guarding a pot of gold. Build a beach scene with HDRIs and models from Poly Haven. Generate a 3D garden gnome with Hyper3D and place it in the scene. Inspect the current scene and convert its layout to a three.js sketch.

Technical details

The system uses a JSON-based protocol over TCP sockets. Commands are JSON objects with a type and optional parameters, while responses return a status and result or a message.

Notes on limitations and usage

Running arbitrary code is powerful but carries risk. Save your work regularly. Complex operations may require breaking tasks into smaller steps.

connect_mcp_blender

Establishes a two-way socket connection between Claude and Blender to enable command exchange and scene manipulation.

get_scene_info

Retrieve detailed information about the current Blender scene, including objects, materials, and lighting.

create_object

Create new 3D objects in the active Blender scene based on prompts or parameters.

delete_object

Remove objects from the scene by name or ID.

modify_object

Change properties of existing objects such as position, rotation, scale, or shape.

apply_material

Apply or modify materials and colors on objects.

execute_blender_code

Run arbitrary Python code inside Blender to perform custom operations.

download_poly_haven_assets

Fetch models, textures, and HDRIs from Poly Haven for use in the scene.

hyper3d_generate_model

Create 3D models using Hyper3D Rodin based on prompts or references.