Blender

You set up a dedicated MCP server that lets Claude Desktop control Blender on Windows. This server runs a Python process that talks to Blender, enabling you to create objects, render scenes, run Python code, and manage your Blender project remotely from the Claude Desktop client.

How to use

You connect to this MCP server from Claude Desktop and send commands to perform Blender operations. Use the available actions to create geometry, run Python scripts inside Blender, render scenes, save work, and inspect or manage objects in the current scene. Each action maps to a Blender operation and is exposed through the MCP interface so you can automate workflows from Claude Desktop without switching to Blender manually.

How to install

Prerequisites you need before installation: Windows 10, Blender 5.0.1, Python 3.8 or newer, and Claude Desktop (latest). You will install a small MCP server that runs alongside Blender and exposes commands to Claude Desktop.

Step 1. Verify Python is installed Open a command prompt and run: python --version

Step 2. Obtain the server files Clone the MCP server repository or download the package, then navigate into the folder:

cd BlenderMCP```
If you prefer, download the ZIP and extract it to a folder of your choice.

Step 3. Install the MCP server dependencies
Run the automatic installer script:
```install.bat```This script installs Python dependencies (including` mcp `and` pydantic`), verifies Blender's path, and confirms completion.

Step 4. Configure Claude Desktop to connect to the MCP server

4-1. Open Claude Desktop configuration file: %APPDATA%\Claude\claude_desktop_config.json.

4-2. Add the Blender MCP server entry to your configuration:

{
  "mcpServers": {
    "blender": {
      "command": "python",
      "args": [
        "C:\\Users\\YourUsername\\BlenderMCP\\blender_mcp_server.py"
      ],
      "env": {
        "BLENDER_PATH": "C:\\Program Files\\Blender Foundation\\Blender 5.0\\blender.exe"
      }
    }
  }
}

Notes:

• Replace C:\Users\YourUsername\BlenderMCP\blender_mcp_server.py with the actual path where you placed the server script.
• If your Blender is installed in a different location, update BLENDER_PATH accordingly.
• Windows paths use double backslashes in JSON strings.

4-3. Restart Claude Desktop to apply the new MCP server configuration.

## Configuration and usage notes

The MCP server is configured to run a Python-based server script that interfaces with Blender via a dedicated environment variable. You should set the Blender executable path in `BLENDER_PATH` so the server can locate Blender. Use the provided example configuration as a template and adjust paths to match your system.

Security and access:
- Ensure Claude Desktop is on the same machine or has network access to the MCP server if you run the server remotely.
- Limit access to trusted clients and consider network controls if you expose the server beyond localhost.

## Troubleshooting

If the MCP server cannot connect from Claude Desktop:

1. Fully restart Claude Desktop.
2. Double-check the path in the configuration file.
3. Verify Python packages are installed by running pip list and confirming the presence of mcp and pydantic.

Blender path errors: ensure the `BLENDER_PATH` environment variable points to your Blender executable. If needed, set it system-wide or in the user environment:
```setx BLENDER_PATH "C:\\Program Files\\Blender Foundation\\Blender 5.0\\blender.exe"```

## Project structure and files

Key files you’ll interact with:
- `blender_mcp_server.py` — the MCP server entry point
- `install.bat` — Windows installer for dependencies
- `claude_desktop_config.json` — Claude Desktop configuration file with MCP server entries
- `.env.example` — environment variable examples (if provided)
Your actual project folder may contain additional files for configuration and deployment.

## Examples you can run from Claude Desktop

Create a cube at a specific location
- name: my\_cube
- location: [0, 0, 0]
- size: 1
Create a sphere at a given location
- name: my\_sphere
- location: [2, 0, 0]
- radius: 2
- subdivisions: 16
Render the current scene to a file
- output\_path: C:\\temp\\scene.png
- resolution\_x: 1920
- resolution\_y: 1080
- samples: 128
Run arbitrary Python code inside Blender
- code: "import bpy; print('Hello from Blender')"
- background: true
Save the current scene to a .blend file
- filepath: C:\\temp\\scene.blend
List objects in the current scene
List objects in the current scene
- (no additional arguments required)

## Available tools

### create\_cube

Create a new cube object in the current Blender scene with a given name, location, and size.

### create\_sphere

Create a UV sphere at a specified location with a given radius and subdivisions.

### execute\_python

Run arbitrary Python code inside Blender, with optional background execution.

### render\_scene

Render the active Blender scene to an image file with configurable resolution and samples.

### save\_blend\_file

Save the current Blender scene to a .blend file at a specified path.

### get\_blender\_info

Retrieve Blender version and installation details.

### list\_objects

List all objects currently present in the scene.

### delete\_object

Delete an object by name from the current scene.