Unity MCP setup guide (2026): connect Claude, Codex or Cursor to Unity
MCP for Unity is the bridge behind a lot of those "the agent just built the scene in Unity" clips. It gives any MCP-capable coding agent tools inside the Unity Editor: create scenes and GameObjects, edit C# scripts, manage assets, run tests, profile and build. Free, MIT-licensed, maintained by CoplayDev/unity-mcp and sponsored by Aura. Not affiliated with Unity Technologies. ~14.9k stars when we checked on Oct 13, 2026.
Step 1: install the Unity package
In the Unity Editor: Window → Package Manager → + → Add package from git URL, then paste:
https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnityPin a release with #v10.3.0 (or #v10.0.0) on the end if you don't want main/beta floating. Or via OpenUPM:
openupm add com.coplaydev.unity-mcpThe package path inside the repo is /MCPForUnity — that's why the ?path=/MCPForUnity query is required.
Step 2: configure your MCP clients
In Unity open Window → MCP for Unity → Configure All Detected Clients. It wires Claude Desktop, Claude Code, Codex, Cursor, VS Code, Windsurf, Cline, Gemini CLI and similar clients. Fully quit and reopen any client that doesn't pick up the new config.
Step 3: prompt it
Try: "Create a cube at the origin and add a Rigidbody." If the bridge is up, the cube appears in the scene in seconds.
What the agent can do
- Create and edit scenes and GameObjects
- Edit C# scripts (with Roslyn validation available)
- Manage assets, run tests, profile and build
- ~50 focused MCP tool entrypoints (see the tool catalog)
- Tool groups for VFX, animation, UI, testing and more
- Multi-instance routing when several Unity editors are open
Advanced
- Multi-instance routing
- Tool groups
- v10 migration / asset generation notes
- Remote-hosted server with auth
Seen on X: @rewind02's cozy fishing game pipeline uses Opus 5.5 + Blender MCP + Unity MCP — never ask for a whole game in one prompt. Pair this guide with our Blender MCP setup.
Branch off beta for contributions (not main). Security reports go through SECURITY.md.
Related: Blender MCP setup, Godot AI setup, games built with coding agents, AI game-dev toolkit.
FAQ
What is Unity MCP / MCP for Unity?
MCP for Unity (CoplayDev/unity-mcp) is a free, MIT-licensed bridge between MCP clients (Claude, Codex, Cursor, VS Code, Windsurf, and more) and the Unity Editor. The LLM gets tools to manage assets, control scenes, edit scripts, run tests and automate workflows. It is sponsored and maintained by Aura, and is not affiliated with Unity Technologies. ~14.9k GitHub stars when we checked on Oct 13, 2026.
What Unity versions does it support?
Unity 2021.3 LTS through Unity 6.x, plus Python 3.10+ via uv. Latest release we checked: v10.3.0, published Oct 4, 2026.
How do I install MCP for Unity?
In Unity: Window → Package Manager → Add package from git URL, then paste https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity (pin #v10.0.0 or a release tag if you want a fixed version). Or use openupm add com.coplaydev.unity-mcp. Then Window → MCP for Unity → Configure All Detected Clients.
Is there another Unity MCP?
CoderGamester/mcp-unity (~1.9k stars) is a separate community MCP plugin for Unity. This guide covers the much larger CoplayDev/unity-mcp project (MCP for Unity).
How many tools does it expose?
The README says about 50 focused MCP tool entrypoints covering scenes, GameObjects, C# scripts, assets, tests, profiling and builds. Full catalog: coplaydev.github.io/unity-mcp/reference/tools/.
Is MCP for Unity free?
Yes — MIT license. Aura also sells a premium Unity/Unreal assistant (Aura for Unity); MCP for Unity itself stays free and open source.