Skip to content
Windsurf

three.ws Blender for Windsurf

io.github.nirholas/blender-mcp

Drive a local Blender headlessly: inspect, convert, render and script 3D files.

client:Windsurf transport:stdio runtime:npm

Install three.ws Blender in Windsurf

~/.codeium/windsurf/mcp_config.json · windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

Held in this page only — never stored, logged, or sent anywhere but back to your screen.

{
  "mcpServers": {
    "blender-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/blender-mcp"
      ],
      "env": {
        "BLENDER_PATH": "<BLENDER_PATH>",
        "BLENDER_MCP_TIMEOUT_MS": "<BLENDER_MCP_TIMEOUT_MS>",
        "BLENDER_MCP_WORKDIR": "<BLENDER_MCP_WORKDIR>",
        "BLENDER_MCP_ALLOW_PYTHON": "<BLENDER_MCP_ALLOW_PYTHON>",
        "BLENDER_MCP_INLINE_IMAGE_BYTES": "<BLENDER_MCP_INLINE_IMAGE_BYTES>",
        "BLENDER_MCP_INLINE_IMAGE_PX": "<BLENDER_MCP_INLINE_IMAGE_PX>",
        "BLENDER_MCP_MAX_CONCURRENCY": "<BLENDER_MCP_MAX_CONCURRENCY>",
        "THREE_WS_BASE": "<THREE_WS_BASE>",
        "THREE_WS_FORGE_TIMEOUT_MS": "<THREE_WS_FORGE_TIMEOUT_MS>",
        "THREE_WS_FORGE_PROVIDER_KEY": "<THREE_WS_FORGE_PROVIDER_KEY>"
      }
    }
  }
}

Global only — Windsurf has no per-project MCP config. Refresh Cascade after saving. Windsurf docs

three.ws Blender in other clients