How to add Unity MCP (AI Game Developer) to Claude Desktop

Connect Claude, Cursor & Windsurf to the Unity Engine for AI-driven game development in Editor and Runtime. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 3.3k★ · stdio · no auth

Claude Desktop config for Unity MCP (AI Game Developer)

npm install -g unity-mcp-cli

{
  "mcpServers": {
    "unity-mcp-ai-game-developer": {
      "command": "<project>/Library/mcp-server/win-x64/gamedev-mcp-server.exe",
      "args": [
        "--port=8080",
        "--plugin-timeout=10000",
        "--client-transport=stdio"
      ]
    }
  }
}

Setup steps

1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
2Paste the Unity MCP (AI Game Developer) config below under the top-level "mcpServers" key.
3Fill in any placeholder secrets (API keys, paths) in the snippet.
4Save the file, then fully quit and reopen Claude Desktop.
5Open a chat and confirm Unity MCP (AI Game Developer)'s tools appear under the 🔌 tools menu.

Before you start

Unity Editor (project path must not contain spaces)
An MCP client / AI agent (Claude Code, Claude Desktop, Cursor, Windsurf, GitHub Copilot, Gemini, etc.)
Node.js / npm if using the unity-mcp-cli for setup
Docker (optional) for the streamableHttp containerized server

What Unity MCP (AI Game Developer) can do in Claude Desktop

gameobject-create

Create a new GameObject in the opened Prefab or in a Scene.

gameobject-modify

Modify GameObjects and/or attached components' fields and properties.

gameobject-component-add

Add a Component to a GameObject.

assets-prefab-create

Create a prefab from a GameObject in the current active scene.

assets-material-create

Create a new material asset with default parameters.

scene-create

Create a new scene in the project assets.

scene-open

Open a scene from the project asset file.

script-update-or-create

Update or create a script file with the provided C# code.

Security

The MCP server is unauthenticated by default (MCP_AUTHORIZATION=none). For remote/cloud (streamableHttp) deployments set --authorization=required and provide a bearer token via --token / MCP_PLUGIN_TOKEN. The server can compile and execute arbitrary C# (script-execute via Roslyn) and call any project method via reflection, so it grants the AI broad control over the Unity project and machine — run it only against trusted projects and clients.

Unity MCP (AI Game Developer) + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Unity MCP (AI Game Developer) config there under the "mcpServers" key and restart the client.

Is Unity MCP (AI Game Developer) safe to use with Claude Desktop?

Which AI agents / MCP clients are supported?

Claude Code (recommended), Claude Desktop, Cursor, Windsurf, GitHub Copilot, Gemini, Antigravity, Cline, Kilo Code, Codex, Rider, Visual Studio, and any other client that supports Skills or dynamic MCP tool updates.

What transports does the server support?

Both stdio and streamableHttp. Use stdio when the MCP client launches the server binary directly (the most common local setup); use streamableHttp when running the server standalone, in Docker, or in the cloud over HTTP.

How do I configure my AI agent?

Open Window/AI Game Developer in Unity and click Auto-generate Skills or Configure MCP, or paste the shown mcpServers JSON into your client manually, or use a CLI command like 'claude mcp add ai-game-developer <command>' / 'gemini mcp add ai-game-developer <command>'.

View repo Full Unity MCP (AI Game Developer) page