Skip to content
MCP server

three.ws Blender

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.5.0
Listing updated
6 days ago

Similar MCP servers

About three.ws Blender

three.ws Blender is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add blender-mcp --env THREE_WS_FORGE_PROVIDER_KEY='<THREE_WS_FORGE_PROVIDER_KEY>' -- npx -y @three-ws/blender-mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "blender-mcp": {
      "type": "stdio",
      "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

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • BLENDER_PATHAbsolute 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_MSCeiling for one Blender job in milliseconds. Renders and heavy conversions are the slow ones.
  • BLENDER_MCP_WORKDIRDirectory for outputs written when a tool is called without an explicit output path.
  • BLENDER_MCP_ALLOW_PYTHONSet to 0 to withdraw blender_run_python, which executes caller-supplied Python inside Blender, from the advertised tool list.
  • BLENDER_MCP_INLINE_IMAGE_BYTESCeiling on inlined image bytes. Past this the image stays on disk and the response says where.
  • BLENDER_MCP_INLINE_IMAGE_PXLongest edge of the render copy returned inline in a tool result. The full-resolution PNG is always written to disk.
  • BLENDER_MCP_MAX_CONCURRENCYHow many Blender processes may run at once. Further calls queue rather than compete for memory.
  • THREE_WS_BASEBase URL of the three.ws deployment backing blender_forge_import.
  • THREE_WS_FORGE_TIMEOUT_MSCeiling for one text-to-3D generation in milliseconds.
  • THREE_WS_FORGE_PROVIDER_KEYMeshy/Tripo API key for the bring-your-own-key geometry lane. The default image lane is free and needs no key.

Pricing

Open source

Prices change. Check three.ws before you buy.

three.ws Blender FAQ

Is three.ws Blender free?

Yes. three.ws Blender is open source, so you can use and self-host it for free.

How do I add three.ws Blender to Claude Code?

Run this command in your terminal: claude mcp add blender-mcp --env THREE_WS_FORGE_PROVIDER_KEY='<THREE_WS_FORGE_PROVIDER_KEY>' -- npx -y @three-ws/blender-mcp

What are the best alternatives to three.ws Blender?

The closest alternatives to three.ws Blender are three.ws 3D Studio, Scenemodel, three.ws 3D Studio (free), WillItBlender and three.ws Audio.

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers