---
title: "MCP Unity: An AI Bridge to the Unity Editor (CoderGamester)"
url: "https://mcpshelf.co/servers/mcp-unity"
description: "MCP Unity lets an assistant build scenes, edit GameObjects and materials, run tests and read the console in the Unity Editor. Package install and config."
updated: "2026-10-27"
site: "MCP Shelf"
---

# MCP Unity

> Lets an assistant build scenes, edit objects and run tests inside the Unity Editor.

Source: https://mcpshelf.co/servers/mcp-unity  
Markdown: https://mcpshelf.co/servers/mcp-unity.md  
Generated: 2026-10-27T13:24:46.127Z

## Facts

- **Name:** MCP Unity
- **Tagline:** Lets an assistant build scenes, edit objects and run tests inside the Unity Editor.
- **Description:** MCP Unity is an open source MCP server and Unity package by CoderGamester that lets AI assistants edit scenes, GameObjects, materials and prefabs, run tests and read the console in the Unity Editor.
- **Repository:** https://github.com/CoderGamester/mcp-unity
- **Install:** `claude mcp add mcp-unity -- node 'ABSOLUTE/PATH/TO/mcp-unity/Server~/build/index.js'`
- **Transport:** stdio (local)
- **Auth:** No required keys or settings listed
- **Tools exposed:** 34: `add_asset_to_scene`, `add_package`, `batch_execute`, `create_prefab`, `create_scene`, `delete_scene`, `duplicate_gameobject`, `delete_gameobject`, `reparent_gameobject`, `get_console_logs`, `get_gameobject`, `get_play_mode_status`, `get_scene_info`, `get_scenes_hierarchy`, `load_scene`, `create_material`, `assign_material`, `modify_material`, `get_material_info`, `execute_menu_item`, `recompile_scripts`, `run_tests`, `save_scene`, `select_gameobject`, `send_console_log`, `set_play_mode_status`, `show_unity_dashboard`, `move_gameobject`, `rotate_gameobject`, `scale_gameobject`, `set_transform`, `unload_scene`, `update_component`, `update_gameobject`
- **Category:** Design, 3D and games (https://mcpshelf.co/categories/design-and-3d)
- **Stats:** 2K GitHub stars, last commit 11 Oct 2026, 0 upvotes on MCP Shelf
- **Install check:** Needs your setup first
- **Listed:** 2026-10-27
- **Page updated:** 2026-10-27

## Full description

### What is MCP Unity?

**MCP Unity is an open source MCP server and Unity package by CoderGamester that lets AI assistants edit scenes, GameObjects, materials and prefabs, run tests and read the console in the Unity Editor.**

MCP Unity, by the developer CoderGamester, is a Unity package with two parts: a WebSocket server that runs inside the Editor, and a small Node.js bridge that your MCP client starts. Through it the model can create and load scenes, add, move and reparent GameObjects, change components and materials, make prefabs, run the Test Runner, recompile scripts and read the console. It is a separate project from the CoplayDev server called MCP for Unity, which is also on this shelf.

The bridge and the Editor talk only on your machine by default, and every connection needs a token that the package generates for each project. Installing Unity packages through the assistant is off until you allow it, because a package can run code in the Editor as it compiles.

|  |  |
| --- | --- |
| Made by | CoderGamester and contributors |
| GitHub | https://github.com/CoderGamester/mcp-unity |
| Licence | MIT |
| GitHub stars | 2K |
| Last commit | 11 Oct 2026 |
| Tools | 34 |
| Runs on | Your computer |
| Install check | Needs your setup first |
| Category | [Design, 3D and games](https://mcpshelf.co/categories/design-and-3d) |
| Setup checked | 27 Oct 2026 |
| Page updated | 27 Oct 2026 |

**Our check:** It needs something our Linux test machine does not have (an account, a desktop app, a Mac or a running service), so on 27 Oct 2026 we read its tools from the source code instead of running this config.

#### MCP Shelf take

> MCP Unity needs something our Linux test machine does not have (an account, an app or a service), so on 27 Oct 2026 we read its source and counted 34 tools. 7 of the 34 only read; the other 27 can change things. It sits 12th of 14 in its category on our shelf by GitHub stars (2K).

— MCP Shelf tests (numbers from our own runs), tested on 27 Oct 2026

### What tools does MCP Unity have?

We listed 34 tools on 27 Oct 2026. 7 only read; the rest can change things or run commands.

| Tool | Kind | What it is for |
| --- | --- | --- |
| `add_asset_to_scene` | changes | Places an asset from the project, such as a prefab, into the scene. |
| `add_package` | changes | Installs a package from the registry, a git URL or a local folder. Disabled until you allow it in the Server Window. |
| `batch_execute` | runs | Runs several tool calls in one request, optionally rolling back all of them if one fails. |
| `create_prefab` | changes | Creates a prefab, optionally with a script attached and its fields filled in. |
| `create_scene` | changes | Creates a scene, optionally adding it to Build Settings. |
| `delete_scene` | changes | Deletes a scene asset from the project. |
| `duplicate_gameobject` | changes | Copies a GameObject, optionally several times or under a new parent. |
| `delete_gameobject` | changes | Deletes a GameObject, with or without its children. |
| `reparent_gameobject` | changes | Moves a GameObject under a different parent in the Hierarchy. |
| `get_console_logs` | reads | Reads the Unity console, filtered by type, a page at a time. |
| `get_gameobject` | reads | Returns a GameObject with its children and components, to a chosen depth. |
| `get_play_mode_status` | reads | Tells you whether the Editor is in Play Mode or paused. |
| `get_scene_info` | reads | Reports the active scene and the other scenes that are loaded. |
| `get_scenes_hierarchy` | reads | Lists every GameObject in the scenes that are loaded. |
| `load_scene` | changes | Opens a scene, on its own or added to those already open. |
| `create_material` | changes | Creates a material with a shader and colour and saves it as an asset. |
| `assign_material` | changes | Puts a material on a GameObject's renderer, in a chosen slot. |
| `modify_material` | changes | Changes a material's colours, numbers or textures. |
| `get_material_info` | reads | Shows a material's shader and every property with its current value. |
| `execute_menu_item` | runs | Runs any Unity Editor menu item by its path, such as GameObject/Create Empty. |
| `recompile_scripts` | changes | Recompiles the project's scripts and returns any compiler messages. |
| `run_tests` | runs | Runs Edit Mode or Play Mode tests in the Test Runner and returns the results. |
| `save_scene` | changes | Saves the current scene, or saves it under a new path. |
| `select_gameobject` | changes | Selects a GameObject in the Hierarchy by path, name or instance ID. |
| `send_console_log` | changes | Writes a message to the Unity console. |
| `set_play_mode_status` | changes | Enters, exits or pauses Play Mode. |
| `show_unity_dashboard` | reads | Opens the MCP Unity dashboard app inside VS Code 1.109 or newer. |
| `move_gameobject` | changes | Moves a GameObject, in world or local space, to a position or by an offset. |
| `rotate_gameobject` | changes | Rotates a GameObject using Euler angles. |
| `scale_gameobject` | changes | Scales a GameObject to a size or by a factor. |
| `set_transform` | changes | Sets position, rotation and scale in one call. |
| `unload_scene` | changes | Closes one of several open scenes. |
| `update_component` | changes | Adds a component to a GameObject or changes its fields. |
| `update_gameobject` | changes | Changes a GameObject's name, tag, layer or active state, creating it if it does not exist. |

### How do I install MCP Unity?

#### What you need first

- Unity 6 or newer
- Node.js 18 or newer
- The MCP Unity package added to your project

1. In Unity, open Window > Package Manager, choose Add package from git URL and enter https://github.com/CoderGamester/mcp-unity.git.
2. Open Tools > MCP Unity > Server Window and click Start Server.
3. Click the Configure button for your client to write its config for you, or paste the config below with the real path to the package. Packages from git live under Library/PackageCache/com.gamelovers.mcp-unity@<hash> in your project.

#### Claude Code

Where: Your terminal, in the project folder

```bash
claude mcp add mcp-unity -- node 'ABSOLUTE/PATH/TO/mcp-unity/Server~/build/index.js'
```

In Unity's Tools > MCP Unity > Server Window, the Configure Claude Code (Project) button writes a .mcp.json with a project-relative path that works for everyone who checks out the project.

#### Cursor

Where: ~/.cursor/mcp.json, or .cursor/mcp.json in a project

```json
{
  "mcpServers": {
    "mcp-unity": {
      "command": "node",
      "args": [
        "ABSOLUTE/PATH/TO/mcp-unity/Server~/build/index.js"
      ]
    }
  }
}
```

#### Claude Desktop

Where: claude_desktop_config.json (Settings → Developer → Edit Config)

```json
{
  "mcpServers": {
    "mcp-unity": {
      "command": "node",
      "args": [
        "ABSOLUTE/PATH/TO/mcp-unity/Server~/build/index.js"
      ]
    }
  }
}
```

#### VS Code

Where: .vscode/mcp.json in your project

```json
{
  "servers": {
    "mcp-unity": {
      "type": "stdio",
      "command": "node",
      "args": [
        "ABSOLUTE/PATH/TO/mcp-unity/Server~/build/index.js"
      ]
    }
  }
}
```

#### Windsurf

Where: ~/.codeium/windsurf/mcp_config.json

```json
{
  "mcpServers": {
    "mcp-unity": {
      "command": "node",
      "args": [
        "ABSOLUTE/PATH/TO/mcp-unity/Server~/build/index.js"
      ]
    }
  }
}
```

#### ChatGPT

Where: Not supported

Not supported: it talks to the Unity Editor on your own machine, and ChatGPT only connects to remote servers.

The hash in the package path changes when the package updates, so run Configure again after an update. UNITY_PORT changes the port from 8090 if you changed it in the Server Window.

Checked against the project's own install docs on 27 Oct 2026: https://github.com/CoderGamester/mcp-unity#readme

### How do I configure MCP Unity?

| Setting | Kind | Required | What it does |
| --- | --- | --- | --- |
| `UNITY_PORT` | env | no | The port of the WebSocket server inside Unity, if you changed it from 8090 in the Server Window. Example: `9001` |
| `UNITY_HOST` | env | no | The address of the machine running Unity, when the bridge runs elsewhere. Needs Allow Remote Connections in the Server Window. Example: `192.168.1.100` |
| `UNITY_REQUEST_TIMEOUT` | env | no | Seconds to wait for Unity to answer a request. The default is 10. Example: `30` |
| `MCP_UNITY_AUTH_TOKEN` | env | no | The project's bridge token, for a bridge that cannot read Library/McpUnity/bridge-token itself. |
| `MCP_UNITY_ALLOW_BATCH_MODE` | env | no | Set to true before launching Unity in -batchmode to run a headless Editor as the MCP host. Example: `true` |

### What can MCP Unity read and change?

**It can read**

- The scene hierarchy, GameObjects, components and materials
- The Unity console and test results
- Project assets, packages and menu items

**It can change**

- Scenes, GameObjects, components, prefabs and materials in your project
- Play Mode state, compiled scripts and installed packages (packages only if allowed)
- Anything a menu item can do, through execute_menu_item

**Safer setup:** Keep the project in version control, leave Allow Package Installation off, and keep remote connections off so only your own machine can reach the Editor.

### Good for

- Laying out scenes and GameObjects by describing them
- Fixing compile errors with the console output in front of the model
- Running Edit Mode and Play Mode tests from the chat

### MCP Unity not working? Common fixes

**The client cannot connect to Unity**
Open Tools > MCP Unity > Server Window and check that the server is started. The client shows up there in green once it connects.

**It stopped working after the package updated**
The package cache path includes a hash that changes on update. Click Configure again or fix the path in your config, then restart the client.

**Requests time out on large scenes**
Raise Request Timeout in the Server Window, or set UNITY_REQUEST_TIMEOUT, and restart the bridge.

**The Node bridge is missing or broken**
Click Force Install Server in the Server Window, or run npm install and npm run build in the package's Server~ folder.

### What are the alternatives to MCP Unity?

| Server | What it does | Tools | Runs on | Licence | Stars |
| --- | --- | --- | --- | --- | --- |
| [MCP Unity](https://mcpshelf.co/servers/mcp-unity) | Lets an assistant build scenes, edit objects and run tests inside the Unity Editor. | 34 | Your computer | MIT | 2K |
| [Draw.io MCP Server (lgazo)](https://mcpshelf.co/servers/drawio-lgazo) | Lets an assistant draw and edit a live draw.io diagram, shape by shape. | 30 | Your computer | MIT | 1.5K |
| [Blender MCP](https://mcpshelf.co/servers/blender) | Prompt-driven modelling in a running copy of Blender. | 9 | Your computer | MIT | 32.5K |
| [Framelink Figma MCP](https://mcpshelf.co/servers/framelink-figma) | Feeds Figma layout and styling to coding agents so the UI matches the design. | 2 | Your computer | MIT | 16.1K |
| [Talk to Figma](https://mcpshelf.co/servers/talk-to-figma) | Read and edit Figma documents from an agent, through a Figma plugin. | 40 | Your computer | MIT | 7.1K |
| [Godot MCP](https://mcpshelf.co/servers/godot) | Launch, run and debug Godot projects, and read the output. | 14 | Your computer | MIT | 6.4K |

### MCP Unity FAQ

#### How do I install MCP Unity?

In Unity, open the Package Manager, choose Add package from git URL and enter https://github.com/CoderGamester/mcp-unity.git. Then open the MCP Unity Server Window from the Tools menu, start the server and click Configure for your AI app.

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

Click Configure Claude Code (Project) in the Server Window, which writes .mcp.json in the project root with a relative path. Or point node at Server~/build/index.js inside the package folder under Library/PackageCache.

#### Which Unity versions does MCP Unity support?

Unity 6 or newer, with Node.js 18 or later to run the bridge server.

#### Is MCP Unity free?

Yes. It is MIT licensed and runs on your own machine, with no account or service behind it.

#### Is MCP Unity safe for my project?

It edits your real project, so keep it in version control. Leave Allow Package Installation off and remote connections off so only your own machine can reach the Editor.

#### Why did MCP Unity stop working after an update?

The package folder name includes a hash that changes on update, so old configs point at a path that no longer exists. Click Configure again to write the new path.

#### Can MCP Unity run my tests?

Yes. run_tests runs Edit Mode and Play Mode tests, and get_console_logs returns compile errors and logs, so the assistant can fix and recheck in a loop.

#### MCP Unity or MCP for Unity?

They are separate projects. MCP Unity by CoderGamester uses a Node bridge and needs Unity 6; MCP for Unity by CoplayDev runs a Python server and supports Unity 2021.3 onwards.

Full docs on GitHub: https://github.com/CoderGamester/mcp-unity

## Notes for agents

Fetch these instead of parsing the HTML page:

- llms.txt: https://mcpshelf.co/llms.txt
- llms-full.txt: https://mcpshelf.co/llms-full.txt
- ai.txt: https://mcpshelf.co/ai.txt
- Full catalog (.md): https://mcpshelf.co/catalog.md
- API spec: https://mcpshelf.co/openapi.json
- MCP server: https://mcpshelf.co/mcp
- MCP manifest: https://mcpshelf.co/.well-known/mcp.json
- Developer docs: https://mcpshelf.co/developers

MCP endpoint (Streamable HTTP, no key): https://mcpshelf.co/mcp. REST API: https://mcpshelf.co/api/v1.