Blender MCP Server

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: `` git clone https://github.com/yourusername/BlenderMCP.git 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)

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.