MCP

MCP for Blender

Connect AI to Blender to help inspect scenes, create objects, and adjust materials.

Translation reviewed

Read the original Chinese text

把 AI 连接到 Blender，协助查看场景、创建物体以及调整材质。

Target: Blender. Based on author documentation.

Connect Blender to Cursor

These steps are based on source documentation. We have not run this resource and tool combination.

Systems: macos. Guide prepared: 2026-11-09.

Requirements

Blender 3.0+, Python 3.10+, uv and Cursor are installed on macOS.
Use an empty scene or a copy. The first task only reads objects.
This community add-on can execute Blender Python. This task does not require additional paid assets or generation services.

Setup steps

Check that uvx is available in your terminal. If uv is missing, follow its official installation instructions before continuing.
Install the add-on as the author describes. Open Blender → Edit → Preferences → Add-ons and enable MCP for Blender.
Add the blender entry below to .cursor/mcp.json at the project root. Merge it with existing MCP configuration without removing other entries.
In the Blender 3D viewport, press N to open the sidebar, find MCP for Blender and start the connection. The button may still say Connect to Claude; it starts the add-on connection.
Quit and reopen Cursor, then check that MCP tools loaded. Run only one matching server on the same port.

Check that uvx is available

uvx --version

Install the Blender add-on as documented

uvx mcp-for-blender install-addon

Cursor project configuration · .cursor/mcp.json

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

First small task

Read only the object list in the current Blender scene and describe the names and types. Do not create, modify or delete any objects.

How to check the result

Blender tools or connection status are visible in Cursor.
Returned object names match the current Blender scene.
Existing objects in the scene were not modified.

Troubleshooting

uvx works in the terminal, but Cursor cannot find it

Find the full path with which uvx, replace command in the configuration, then quit and reopen Cursor.

Connection failed or port in use

Check that the Blender add-on connection is running and stop duplicate MCP instances on the same port. The host and port must match the author settings.

Python dependency installation failed

Read the author’s Pin the Python version section and check the required version. Avoid repeatedly installing unknown packages.

How to disable it

Disable the MCP in Cursor, or remove only its blender entry from .cursor/mcp.json and restart.
Stop the connection in the Blender add-on panel. To disable it, turn off the add-on in Add-ons.

Author installation and Cursor configuration ↗Cursor MCP configuration documentation ↗