Blender MCP

1.5.6 verified Mon Apr 27 auth: no python

Blender integration through the Model Context Protocol (MCP). Enables AI agents to control Blender via natural language commands. Current version 1.5.6, requires Python >=3.10. Regular updates.

pip install blender-mcp

Common errors

error ModuleNotFoundError: No module named 'blender_mcp' ↓

cause Package not installed or wrong Python environment.

fix

Run pip install blender-mcp in the correct environment (Python 3.10+).

error ConnectionRefusedError: [Errno 61] Connection refused ↓

cause Blender not running or add-on not enabled.

fix

Launch Blender, install and enable the MCP add-on, then retry.

Warnings

breaking Before version 1.4.0, the client required manual Blender socket setup. Now handled automatically. ↓

fix Upgrade to latest version and remove any manual socket configuration.

gotcha Blender MCP requires Blender to be running with the add-on enabled. The package alone does not launch Blender. ↓

fix Install the Blender add-on from the repository and enable it before using the client.

Imports

BlenderMCPClient

from blender_mcp import BlenderMCPClient

Quickstart

Initialize client and send a natural-language command to Blender.

import os
from blender_mcp import BlenderMCPClient

client = BlenderMCPClient()
result = client.execute("create a cube at origin")
print(result)