MCP for Blender
Menu MCP Clients

Get Started

MCP Client Setup: Claude, Cursor, VS Code, and More

Configure MCP for Blender with Claude Desktop, Claude Code, Cursor, VS Code, OpenCode, and Antigravity. Includes per-client JSON configs and troubleshooting notes.

MCP for Blender works with any MCP-compatible client. Below are step-by-step configurations for every supported client. Only run one client instance at a time, because multiple clients trying to connect to the same server will conflict.

Only run ONE instance of the MCP server at a time. Do not connect both Claude Desktop and Cursor to MCP for Blender simultaneously.

Claude Desktop uses a JSON config file to register MCP servers. Watch the setup video or follow the steps below.

VideoClaude Desktop setup for MCP for Blender
  1. Open the config file

    In Claude Desktop, go to Settings → Developer → Edit Config to open claude_desktop_config.json.

  2. Add the MCP for Blender entry

    Paste this JSON inside the mcpServers object:

    {
      "mcpServers": {
        "blender": {
          "command": "uvx",
          "args": ["mcp-for-blender"]
        }
      }
    }
  3. Fully quit and relaunch Claude Desktop

    On macOS, press Cmd+Q to fully quit. On Windows, quit from the system tray icon. Reopen Claude Desktop so it reloads the config.

Claude Code is a terminal-based client. Add MCP for Blender with a single command:

claude mcp add blender uvx mcp-for-blender

This registers the server automatically. Restart Claude Code if it was already running.

The Codex CLI, desktop app, and IDE extension all share the same config file (~/.codex/config.toml), so setting the server up once covers all three.

  1. Register the server

    Use the Codex CLI:

    codex mcp add blender -- uvx mcp-for-blender

    Or add it by hand to ~/.codex/config.toml (or $CODEX_HOME/config.toml):

    [mcp_servers.blender]
    command = "uvx"
    args = ["mcp-for-blender"]

    Or in the Codex desktop app: Settings → MCP servers → Add server, name it blender, pick STDIO, enter uvx mcp-for-blender as the command, then Save and restart. If the app can't find uvx, use its full path instead. See the Installation page for PATH troubleshooting.

  2. Verify it registered

    Run codex mcp list and confirm the blender server shows as enabled. The tools become available the next time you start Codex.

  3. Set environment variables (optional)

    To use a non-default Blender host or port, pass --env KEY=VALUE flags to codex mcp add, or add them in the config file:

    [mcp_servers.blender]
    command = "uvx"
    args = ["mcp-for-blender"]
    env = { BLENDER_HOST = "localhost", BLENDER_PORT = "9876" }

Cursor registers MCP servers through its settings UI. Watch the setup video or follow the steps below.

VideoCursor setup for MCP for Blender
  1. Open MCP settings

    Use the one-click install link, or go to Settings → MCP. Add it as a global server, or create .cursor/mcp.json in your project root for a project-specific server.

  2. Paste the config JSON

    On macOS, paste this JSON directly:

    {
      "command": "uvx",
      "args": ["mcp-for-blender"]
    }
  3. Windows users: use cmd wrapper

    On Windows, use this instead so Cursor can resolve uvx:

    {
      "command": "cmd",
      "args": ["/c", "uvx", "mcp-for-blender"]
    }

VS Code supports MCP servers through its agent and copilot features.

Add this to your VS Code MCP configuration:

{
  "servers": {
    "blender": {
      "type": "stdio",
      "command": "uvx",
      "args": ["mcp-for-blender"]
    }
  }
}

Restart VS Code after saving the config.

OpenCode uses a top-level mcp key with a local server type and a command array.

{
  "mcp": {
    "blender": {
      "type": "local",
      "command": ["uvx", "mcp-for-blender"],
      "enabled": true
    }
  }
}

Save the config and restart OpenCode to apply changes.

Antigravity supports environment variables alongside the command config.

{
  "mcpServers": {
    "blender": {
      "command": "uvx",
      "args": ["mcp-for-blender"],
      "env": {
        "BLENDER_HOST": "localhost",
        "BLENDER_PORT": "9876"
      }
    }
  }
}

Restart Antigravity after updating the configuration.

If your client cannot find uvx, use the full path from which uvx (macOS/Linux) or where uvx (Windows) as the "command" value. See the Installation page for detailed PATH troubleshooting.