home / mcp / blender mcp server

Blender MCP Server

Connects Blender to Claude AI via MCP, enabling scene inspection, object manipulation, material control, and code execution from Claude.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can connect Blender with Claude AI using the Blender MCP Server, enabling prompt-driven 3D modeling, scene creation, and live Blender control through a lightweight, socket-based protocol. This setup lets you issue commands from Claude to manipulate objects, materials, and the scene, or to run Python code inside Blender for automation and experimentation.

How to use

To use the Blender MCP Server, you run a local MCP client (for example Claude with the Blender MCP configuration) and ensure the Blender side is actively listening for commands. You then initiate the connection from Blender by turning on the MCP client in the Blender interface and starting the Claude side’s MCP server configuration. Once connected, you can ask Claude to inspect the scene, create or modify objects, apply materials, and execute Python code directly in Blender. You can also enable optional asset pipelines such as Poly Haven to download models, textures, and HDRIs, and use Hyper3D Rodin for AI-generated models.

How to install

Prerequisites you need before installation.

1) Install Blender 3.0 or newer
2) Install Python 3.10 or newer
3) Install uv package manager (required for Mac and Windows integration)

Additional configuration and usage notes

MCP server configuration is embedded in your integration setup. The following explicit configuration enables the Blender MCP server as a local stdio process monitored by your MCP client.

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

Troubleshooting

Connection issues usually stem from the MCP server not running or the Blender addon not being active. Verify that the Blender add-on is installed and enabled, and that the MCP server is started on the client side. If you encounter timeouts, try breaking requests into smaller steps. If you still face problems, restart both Blender and the MCP client, and re-establish the connection.

Security and reliability notes

The system can execute arbitrary Python code inside Blender. Use this capability with caution, especially in production environments. Always save your work before running code through the MCP channel. If you do not want to use asset libraries like Poly Haven, disable the corresponding option in Blender.

Telemetry and privacy

Anonymous telemetry may be collected to improve BlenderMCP. You can disable telemetry from Blender preferences or run the server with an environment variable to opt out entirely.

Examples of tasks you can request

- Create a low-poly dungeon scene with atmospheric lighting and a guarding dragon. - Generate a beach scene using HDRIs, textures, and assets from Poly Haven. - Import a reference image and reproduce a Blender scene from it. - Generate a 3D model using Hyper3D Rodin. - Query scene information and export a Three.js sketch.

Hyper3D integration

Hyper3D integration allows generating AI-created models. Note that the free trial may have daily limits; obtain a personal key for extended access if needed.

Available tools

connect_blender

Establishes the MCP connection between Claude and Blender, enabling subsequent commands.

manipulate_objects

Create, modify, and delete 3D objects within the Blender scene.

manage_materials

Apply, modify, and assign materials and colors to objects.

inspect_scene

Query detailed information about the current Blender scene and its objects.

execute_blender_code

Run arbitrary Python code inside Blender via the MCP connection.

fetch_poly_haven_assets

Download models, textures, and HDRIs from the Poly Haven API when enabled.

hyper3d_rodin_generation

Request AI-generated 3D models through Hyper3D Rodin.