BlenderMCP for Claude Desktop: Setup & Config

What you can do with BlenderMCP in Claude Desktop

Combine prompt-driven Blender editing with scene inspection and optional external 3D asset pipelines.

• Inspect a Blender scene and individual object properties.
• Create geometry and modify materials from an assistant conversation.
• Find and import Poly Haven or downloadable Sketchfab assets.

Before you start: BlenderMCP in Claude Desktop

• Blender 3.0 or later
• Python 3.10 or later
• uv with uvx available for this setup
• The repository's addon.py installed and enabled in Blender
• An MCP-compatible client

Configure the MCP client, install the addon, and connect it through Blender's BlenderMCP sidebar. Run only one server instance across clients. Optional BLENDER_HOST and BLENDER_PORT customize the socket connection; DISABLE_TELEMETRY=true disables telemetry.

BlenderMCP Claude Desktop configuration

1. Choose Claude Desktop configuration scope

   For BlenderMCP, open macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json. Merge under mcpServers via Settings → Developer → Edit Config when available.

2. Add BlenderMCP to Claude Desktop

   Use the blender-mcp entry below in mcpServers. Keep BlenderMCP's documented stdio connection fields and your other Claude Desktop entries.

3. Check BlenderMCP in Claude Desktop

   BlenderMCP: Fully quit and reopen Claude Desktop; check developer diagnostics.

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

BlenderMCP tools available to Claude Desktop

BlenderMCP's stored tool list documents 17 tools; compare it with Claude Desktop's connected tool list, because the stored list is not a live check.

get_scene_info

When Claude Desktop requests get_scene_info from BlenderMCP, review the action before approving it.

Inspect the current Blender scene.

get_object_info

When Claude Desktop requests get_object_info from BlenderMCP, review the action before approving it.

Read details for a named scene object.

get_viewport_screenshot

When Claude Desktop requests get_viewport_screenshot from BlenderMCP, review the action before approving it.

Capture the Blender viewport as an image.

execute_blender_code

When Claude Desktop requests execute_blender_code from BlenderMCP, review the action before approving it.

Run arbitrary Python inside Blender; use small steps and save work first.

get_polyhaven_categories

When Claude Desktop requests get_polyhaven_categories from BlenderMCP, review the action before approving it.

List Poly Haven categories for a chosen asset type.

search_polyhaven_assets

When Claude Desktop requests search_polyhaven_assets from BlenderMCP, review the action before approving it.

Find Poly Haven assets with optional type and category filters.

download_polyhaven_asset

When Claude Desktop requests download_polyhaven_asset from BlenderMCP, review the action before approving it.

Download and import a selected Poly Haven asset.

set_texture

When Claude Desktop requests set_texture from BlenderMCP, review the action before approving it.

Apply a downloaded Poly Haven texture to a scene object.

get_polyhaven_status

When Claude Desktop requests get_polyhaven_status from BlenderMCP, review the action before approving it.

Check whether Poly Haven integration is enabled.

get_hyper3d_status

When Claude Desktop requests get_hyper3d_status from BlenderMCP, review the action before approving it.

get_sketchfab_status

When Claude Desktop requests get_sketchfab_status from BlenderMCP, review the action before approving it.

search_sketchfab_models

When Claude Desktop requests search_sketchfab_models from BlenderMCP, review the action before approving it.

download_sketchfab_model

When Claude Desktop requests download_sketchfab_model from BlenderMCP, review the action before approving it.

generate_hyper3d_model_via_text

When Claude Desktop requests generate_hyper3d_model_via_text from BlenderMCP, review the action before approving it.

generate_hyper3d_model_via_images

When Claude Desktop requests generate_hyper3d_model_via_images from BlenderMCP, review the action before approving it.

poll_rodin_job_status

When Claude Desktop requests poll_rodin_job_status from BlenderMCP, review the action before approving it.

import_generated_asset

When Claude Desktop requests import_generated_asset from BlenderMCP, review the action before approving it.

BlenderMCP: full stored tool descriptions

Troubleshooting BlenderMCP in Claude Desktop

• Fully quit and reopen Claude Desktop for BlenderMCP. If uvx blender-mcp (from uv, for Python tools) is missing, check the desktop process's PATH, which may differ from your terminal.
• BlenderMCP uses stdio here: Claude Desktop must keep the configured process running; protocol output belongs on stdout and diagnostics on stderr.
• Known limitation: Requires Blender, an enabled addon, and a separate MCP server connection.
• Known limitation: Arbitrary Python execution can be dangerous and warrants saving work first.
• Known limitation: Complex operations may need to be split into smaller steps.
• General Claude Desktop troubleshooting lives in the /clients/claude-desktop guide.

Frequently asked questions