three.ws Blender MCP Server

by nirholasio.github.nirholas/blender-mcpv0.5.0

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

228Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active1d ago

Install three.ws Blender MCP server

claude mcp add blender -e THREE_WS_FORGE_PROVIDER_KEY='<three-ws-forge-provider-key>' -- npx -y @three-ws/blender-mcp

{
  "mcpServers": {
    "blender": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/blender-mcp"
      ],
      "env": {
        "THREE_WS_FORGE_PROVIDER_KEY": "<three-ws-forge-provider-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "blender": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/blender-mcp"
      ],
      "env": {
        "THREE_WS_FORGE_PROVIDER_KEY": "<three-ws-forge-provider-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "blender": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/blender-mcp"
      ],
      "env": {
        "THREE_WS_FORGE_PROVIDER_KEY": "<three-ws-forge-provider-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "blender": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/blender-mcp"
      ],
      "env": {
        "THREE_WS_FORGE_PROVIDER_KEY": "<three-ws-forge-provider-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
BLENDER_PATH	—	—	Absolute path to the Blender 3.0+ executable. Leave unset to discover it on PATH and at the platform's standard install locations.
BLENDER_MCP_TIMEOUT_MS	—	—	Ceiling for one Blender job in milliseconds. Renders and heavy conversions are the slow ones.
BLENDER_MCP_WORKDIR	—	—	Directory for outputs written when a tool is called without an explicit output path.
BLENDER_MCP_ALLOW_PYTHON	—	—	Set to 0 to withdraw blender_run_python, which executes caller-supplied Python inside Blender, from the advertised tool list.
BLENDER_MCP_INLINE_IMAGE_BYTES	—	—	Ceiling on inlined image bytes. Past this the image stays on disk and the response says where.
BLENDER_MCP_INLINE_IMAGE_PX	—	—	Longest edge of the render copy returned inline in a tool result. The full-resolution PNG is always written to disk.
BLENDER_MCP_MAX_CONCURRENCY	—	—	How many Blender processes may run at once. Further calls queue rather than compete for memory.
THREE_WS_BASE	—	—	Base URL of the three.ws deployment backing blender_forge_import.
THREE_WS_FORGE_TIMEOUT_MS	—	—	Ceiling for one text-to-3D generation in milliseconds.
THREE_WS_FORGE_PROVIDER_KEY	—	yes	Meshy/Tripo API key for the bring-your-own-key geometry lane. The default image lane is free and needs no key.

Freshness

Active — last maintenance signal 1d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-08 · 1d ago · GitHub
Latest release
2026-09-30 · 9d ago · GitHub · v1.5.2
Package published
no data · npm/PyPI
Registry entry updated
2026-09-30 · 9d ago · official registry · v0.5.0

FAQ

›How do I install the three.ws Blender MCP server in Claude Code?

Run: claude mcp add blender -e THREE_WS_FORGE_PROVIDER_KEY='<three-ws-forge-provider-key>' -- npx -y @three-ws/blender-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does three.ws Blender require an API key?

Yes. It expects THREE_WS_FORGE_PROVIDER_KEY, of which 1 is a secret.

›Can I use three.ws Blender as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is three.ws Blender in the official MCP registry?

Yes, as io.github.nirholas/blender-mcp.