Home / MCP / Blender MCP Server

Blender MCP Server

Connect Blender to Claude via MCP to create, modify, and inspect 3D scenes from prompts.

python

14.4kstars

View on GitHub

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
    "mcpServers": {
        "blender": {
            "command": "uvx",
            "args": [
                "blender-mcp"
            ],
            "env": {
                "BLENDER_HOST": "localhost",
                "BLENDER_PORT": "9876"
            }
        }
    }
}

You connect Blender to Claude AI through the Blender MCP Server to control and inspect your Blender scene directly from prompts. This enables prompt-driven modeling, scene setup, and real-time manipulation, turning ideas into 3D work without leaving Blender.

How to use

You run a local MCP server that listens for commands from Claude and forwards them to Blender. Start the server, then in Claude configure the MCP connection so Claude can send requests like creating objects, changing materials, or executing Python code in Blender. You can enable optional asset access to Poly Haven for models, HDRIs, and textures.

How to install

Prerequisites you need before starting:

Blender 3.0 or newer
Python 3.10 or newer
uvx package manager (required)

Install uvx if you haven’t already, then install and run the Blender MCP components as described below.

# Install uvx on macOS using Homebrew
brew install uv

# On Windows, install uvx and ensure it’s on your PATH
# PowerShell (example already provided in setup):
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
$localBin = "$env:USERPROFILE\.local\bin"
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", "$userPath;$localBin", "User")

Starting and wiring up the MCP server

1) Start the Blender MCP server process in your terminal or command prompt using the provided Nguyen/uvx-based command sequence. 2) In Blender, enable the Blender MCP Addon to open the MCP interface in the 3D View sidebar. 3) In Claude, configure the MCP server so Claude can communicate with your local Blender instance.

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

What you can do once connected

- Retrieve information about the current scene and objects - Create, delete, or modify objects and their transforms - Apply or adjust materials and colors - Execute Python code inside Blender from Claude - Download models, textures, and HDRIs via Poly Haven - Generate AI-assisted 3D content through integrations like Hyper3D Rodin.

Available tools

get_scene_info

Query the current Blender scene and objects to present a structured summary to Claude.

manipulate_objects

Create, delete, or modify objects, including transforms and visibility.

apply_materials

Assign or modify materials and colors on objects.

execute_blender_code

Run arbitrary Python code inside Blender from Claude.

poly_haven_download

Download models, textures, and HDRIs through Poly Haven integration.

hyper3d_generation

Trigger AI-generated 3D models via Hyper3D Rodin integration.