# Unity MCP

> Unity MCP is an open-source MCP server for developer tools. AI agents inspect and edit a running Unity Editor: scenes, prefabs, tests and builds. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Windows, macOS, Linux, CLI
- **Website:** https://unity-mcp.shiranui-isuzu.dev/en/
- **Repository:** https://github.com/isuzu-shiranui/unitymcp
- **MCP Registry name:** dev.shiranui-isuzu/unity-mcp
- **Categories:** developer tools, games and play
- **Listing updated:** 2026-11-16

## About

There is no separate server process. The Unity Editor itself exposes a local Streamable HTTP endpoint and writes a descriptor file that the command line tool reads, so no port or token has to be configured. The README reports it working with Claude Code, Cursor, Codex, Gemini CLI, VS Code and Claude Desktop, and the project must stay open in the Editor while it is used.

Tools fall into diagnostics (console, Editor.log, compile state, tests, scene hierarchy, asset reads), authoring (GameObjects, components, assets, scenes, prefabs, Animator Controllers), rendering, Timeline and Recorder, builds, C# snippet execution and synthesised Editor input. Each authoring call is one Undo step. Timeline, Recorder and test tools appear only when the matching Unity packages are installed, and a URL parameter can limit the tool list to chosen groups. A verify command recompiles and collects errors in one call, optionally running tests.

New tools are added by putting an attribute on a C# static method. Installation is through the Package Manager from a Git URL or through VCC and ALCOM, and the code is MIT licensed. It needs Unity 2022.3 or newer; the documentation is in Japanese with English, and a no-command-line route uses a Claude Desktop extension.

## Features

- **In-Editor server:** The Editor serves the MCP endpoint directly, with no separate process.
- **Diagnostics tools:** Reads console, log, compile status, tests, hierarchy and assets.
- **Scene and asset authoring:** Creates and changes GameObjects, components, prefabs, scenes and Animator Controllers.
- **Undo-friendly edits:** Each authoring call collapses into one Undo operation.
- **Verify command:** Recompiles, extracts errors and optionally runs tests in one call.
- **Custom tools:** Add a tool by tagging a C# static method.
- **Tool groups:** Limits the tool list to groups such as diagnostics or authoring.

## Good for

- Ask an agent to add objects to a scene and read back Console errors
- Recompile after script edits and list the errors
- Run EditMode tests from an agent
- Automate Timeline or Recorder setup
- Build a project from the command line

## Install

### Claude Code (Terminal)

```sh
claude mcp add unity-mcp -- dnx IsuzuUnityCli --yes
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "unity-mcp": {
      "command": "dnx",
      "args": [
        "IsuzuUnityCli",
        "--yes"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "unity-mcp": {
      "command": "dnx",
      "args": [
        "IsuzuUnityCli",
        "--yes"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "unity-mcp": {
      "type": "stdio",
      "command": "dnx",
      "args": [
        "IsuzuUnityCli",
        "--yes"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "unity-mcp": {
      "command": "dnx",
      "args": [
        "IsuzuUnityCli",
        "--yes"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "unity-mcp": {
      "command": "dnx",
      "args": [
        "IsuzuUnityCli",
        "--yes"
      ]
    }
  }
}
```

## Tools

- `play_mode_status`: Reports whether the Editor is in play mode
- `test_run`: Runs tests when the Unity test framework is present
- `test_results`: Returns test results

## FAQ

### What Unity version is required?

Unity Editor 2022.3 or newer.

### Do I need to run a separate server?

No. The Editor exposes the endpoint and starts it when the project opens.

### Can I use it without a terminal?

Yes, one route uses a Claude Desktop extension after adding the package in Unity.

### Which clients are verified?

Claude Code, Cursor, Codex, Gemini CLI, VS Code and Claude Desktop.

### What licence is it?

MIT.

### Is Unity MCP free?

Yes. Unity MCP is open source, so you can use and self-host it for free.

### How do I add Unity MCP to Claude Code?

Run this command in your terminal: claude mcp add unity-mcp -- dnx IsuzuUnityCli --yes

### What are the best alternatives to Unity MCP?

The closest alternatives to Unity MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/unity-mcp
