MCP Directory

How to add BlenderMCP to Windsurf

Control Blender from Claude and other LLMs for prompt-assisted 3D modeling, scene creation, and asset generation. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

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

Windsurf 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 Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the BlenderMCP config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5BlenderMCP's tools become available to Cascade.

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 Windsurf

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 + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the BlenderMCP config there under the "mcpServers" key and restart the client.

Is BlenderMCP safe to use with Windsurf?

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