MCP Directory

How to add BlenderMCP to Claude Desktop

Control Blender from Claude and other LLMs for prompt-assisted 3D modeling, scene creation, and asset generation. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 23k★ · stdio · no auth

Claude Desktop config for BlenderMCP

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

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Setup steps

  1. 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
  2. 2Paste the BlenderMCP config below under the top-level "mcpServers" key.
  3. 3Fill in any placeholder secrets (API keys, paths) in the snippet.
  4. 4Save the file, then fully quit and reopen Claude Desktop.
  5. 5Open a chat and confirm BlenderMCP's tools appear under the 🔌 tools menu.

Before you start

  • Blender 3.0 or newer
  • Python 3.10 or newer
  • uv package manager (or pipx as an alternative)
  • The BlenderMCP add-on (addon.py) installed and enabled in Blender
  • Optional: Sketchfab / Hyper3D / Hunyuan3D API keys for those integrations

What BlenderMCP can do in Claude Desktop

get_scene_info

Get detailed information about the current Blender scene.

get_object_info

Get detailed information about a specific object in the scene by name.

get_viewport_screenshot

Capture a screenshot of the Blender viewport so the model can see the scene.

execute_blender_code

Run arbitrary Python code inside Blender (powerful and potentially dangerous).

get_polyhaven_categories

List available asset categories on Poly Haven for a given asset type (e.g. hdris).

search_polyhaven_assets

Search Poly Haven for models, textures, and HDRIs.

download_polyhaven_asset

Download a Poly Haven asset into the Blender scene.

set_texture

Apply a downloaded texture to an object.

Security

The execute_blender_code tool runs arbitrary Python code inside Blender, which is powerful but potentially dangerous — use with caution and always save your work before using it. BlenderMCP collects anonymous telemetry by default; disable it with the DISABLE_TELEMETRY=true environment variable or via the add-on preferences. Poly Haven, Sketchfab, Hyper3D, and Hunyuan3D integrations require downloading assets / calling external APIs and can be turned off.

BlenderMCP + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the BlenderMCP config there under the "mcpServers" key and restart the client.

Is BlenderMCP safe to use with Claude Desktop?

The execute_blender_code tool runs arbitrary Python code inside Blender, which is powerful but potentially dangerous — use with caution and always save your work before using it. BlenderMCP collects anonymous telemetry by default; disable it with the DISABLE_TELEMETRY=true environment variable or via the add-on preferences. Poly Haven, Sketchfab, Hyper3D, and Hunyuan3D integrations require downloading assets / calling external APIs and can be turned off.

Do I need anything inside Blender besides the MCP server?

Yes. You must install the bundled addon.py add-on in Blender (Edit > Preferences > Add-ons > Install), enable 'Interface: Blender MCP', then in the 3D View sidebar open the 'BlenderMCP' tab and click 'Connect to Claude'. The MCP server in your client talks to this add-on over a TCP socket.

Is this an official Blender product?

No. It is a third-party integration made by Siddharth Ahuja and is not made by Blender.

Should I run the uvx command in my terminal myself?

No. Let the MCP client start the server. Running 'uvx blender-mcp' manually in a terminal is called out as a common cause of connection issues.

View repo Full BlenderMCP page