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

Blender MCP 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 Blender MCP simultaneously.

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

Open the config file

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

Add the Blender MCP entry

Paste this JSON inside the mcpServers object:

{
  "mcpServers": {
    "blender": {
      "command": "uvx",
      "args": ["blender-mcp"]
    }
  }
}

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 Blender MCP with a single command:

claude mcp add blender uvx blender-mcp

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

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

Open MCP settings

Go to Settings → MCP.

Paste the config JSON

On macOS, paste this JSON directly:

{
  "command": "uvx",
  "args": ["blender-mcp"]
}

Windows users: use cmd wrapper

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

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

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": ["blender-mcp"]
    }
  }
}

Restart VS Code after saving the config.

OpenCode uses a local server type with a command array.

{
  "mcpServers": {
    "blender": {
      "type": "local",
      "command": ["uvx", "blender-mcp"]
    }
  }
}

Save the config and restart OpenCode to apply changes.

Antigravity supports environment variables alongside the command config.

{
  "mcpServers": {
    "blender": {
      "command": "uvx",
      "args": ["blender-mcp"],
      "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.

Get Started

Core Concepts

Integrations

Use Cases

Reference

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