Blender

Connect Claude AI to Blender via MCP to manipulate scenes, objects, materials, and run Python in Blender.

python

2

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "johncarlo177-python.blendermcp": {
      "command": "uvx",
      "args": [
        "blender-mcp"
      ]
    }
  }
}

BlenderMCP lets you connect Blender to Claude AI through the Model Context Protocol, enabling prompt-driven 3D modeling, scene creation, and direct control of Blender from Claude. This bridge lets you generate, adjust, and inspect Blender scenes using natural language prompts and AI assistance.

How to use

You will run a local MCP server that Blender connects to and a client (Claude) that sends commands to Blender. Start Blender with the Blender MCP Addon active, then start the MCP server in your terminal. In Claude, configure the MCP server so Claude can reach Blender via the local server. Use Claude to issue prompts like creating objects, applying materials, inspecting the scene, or executing Python code inside Blender.

How to install

Prerequisites must be satisfied before setup:

Blender 3.0 or newer
Python 3.10 or newer
UV package manager (uv) installed

UV installation commands by platform:

Mac: install uv with Homebrew

brew install uv

Windows: install uv via PowerShell script and update PATH

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

Starting the connection and usage flow

Start Blender and enable the Blender MCP Addon. 2) Start the MCP server in your terminal. 3) In Claude, ensure the MCP server configuration points to the running server. 4) In Blender, open the 3D View sidebar and use the BlenderMCP tab to connect to Claude. 5) In Claude, enable asset sources if you want Poly Haven assets, and then issue prompts to create and modify scenes.

Available tools

get_scene_info

Retrieve detailed information about the current Blender scene, including objects, materials, cameras, lights, and the active context.

create_object

Create a new 3D object in the scene with specified type, dimensions, and location.

delete_object

Remove a specified object from the scene.

modify_object

Change properties of an existing object, such as transform, scale, or visibility.

apply_material

Assign 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 via the integrated API.

hyper3d_rodin_generate

Generate AI-assisted 3D models through Hyper3D Rodin integration.