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

Data as of

MCP for Unity for Claude Code: Setup & Config

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

MCP for Unity Claude Code configuration

  1. Choose Claude Code configuration scope

    For MCP for Unity, open Project scope: .mcp.json at the repository root. Project JSON: merge into mcpServers; user scope: use the CLI.

  2. Add MCP for Unity to Claude Code

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

  3. Check MCP for Unity in Claude Code

    MCP for Unity: Inspect claude mcp list and /mcp status.

Config file · Project scope: .mcp.json at the repository root

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

CLI (POSIX shell)
claude mcp add-json --scope project 'unity-mcp' '{"type":"stdio","command":"openupm","args":["add","com.coplaydev.unity-mcp"],"env":{}}'

MCP for Unity in Claude Code: stdio checks

  • MCP for Unity's openupm add command installs a Unity package. Follow the upstream editor setup before expecting a stdio connection in Claude Code.
  • If MCP for Unity fails to start, check openupm, the working directory, and Claude Code's selected scope; inspect claude mcp list and /mcp.

MCP for Unity — details. Claude Code guide

Frequently asked questions

Register MCP for Unity with the displayed claude mcp add-json --scope project command, or merge the JSON into .mcp.json at the repository root.

Claude Code's unity-mcp example uses stdio.

MCP for Unity's Claude Code 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 Code.