1. Home
  2. MCP for Unity
  3. MCP for Unity for Claude Desktop: Setup & Config

Data as of

MCP for Unity for Claude Desktop: Setup & Config

MCP for Unity links Claude Desktop to the Unity Editor for scene work, asset management, script editing, testing, and builds.

What you can do with MCP for Unity in Claude Desktop

Connect AI-assisted coding with direct Unity scene, asset, testing, and build operations.

  • Create scenes and GameObjects from natural-language instructions.
  • Edit C# scripts while working with Unity Editor state.

Before you start: MCP for Unity in Claude Desktop

  • Unity 2021.3 LTS through 6.x
  • Python 3.10 or later via uv
  • An MCP-compatible client
  • OpenUPM when using this installation command

This command installs the Unity package, not a standalone MCP launch process. Alternatively, add https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main in Package Manager, then use Window > MCP for Unity > Configure All Detected Clients. Individual tool names and a standalone server launch command are not stated in the README.

MCP for Unity Claude Desktop configuration

  1. Choose Claude Desktop configuration scope

    For MCP for Unity, open macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json. Merge under mcpServers via Settings → Developer → Edit Config when available.

  2. Add MCP for Unity to Claude Desktop

    Use the unity-mcp entry below in mcpServers. Keep MCP for Unity's documented stdio connection fields and your other Claude Desktop entries.

  3. Check MCP for Unity in Claude Desktop

    MCP for Unity: Fully quit and reopen Claude Desktop; check developer diagnostics.

Config file · macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

JSON
{
  "mcpServers": {
    "unity-mcp": {
      "command": "openupm",
      "args": [
        "add",
        "com.coplaydev.unity-mcp"
      ],
      "env": {}
    }
  }
}

Troubleshooting MCP for Unity in Claude Desktop

  • MCP for Unity's openupm add command installs a Unity package. Follow the upstream editor setup before expecting a stdio connection in Claude Desktop.
  • Fully quit and reopen Claude Desktop for MCP for Unity. If openupm is missing, check the desktop process's PATH, which may differ from your terminal.
  • Known limitation: Requires a supported Unity installation and Python through uv.
  • Known limitation: Individual tool identifiers are not stated in the supplied README.
  • Known limitation: Advanced routing and remote authentication require separate documentation.
  • General Claude Desktop troubleshooting lives in the /clients/claude-desktop guide.

MCP for Unity — details. Claude Desktop guide

Frequently asked questions

Claude Desktop loads MCP for Unity from claude_desktop_config.json: ~/Library/Application Support/Claude/ on macOS, or %APPDATA%\Claude\ on Windows. Open it via Settings → Developer → Edit Config when available.

Claude Desktop's unity-mcp example uses stdio.

MCP for Unity's Claude Desktop configuration invokes openupm. MCP for Unity's openupm add command installs a Unity package. Follow the upstream editor setup before expecting a stdio connection in Claude Desktop.

It lists Unity 2021.3 LTS through 6.x, together with Python 3.10 or later through uv.

No. The README describes compatibility with any MCP client and names Claude, Codex, VS Code, local LLMs, and others.