unity-mcp README

The project's README from github.com/CoplayDev/unity-mcp. As one markdown file: README.md.

MCP for Unity

English ↔ 简体中文    |    Discord ↔ Wiki

Proudly sponsored and maintained by Aura — the AI assistant for Unreal & Unity.

And don't miss Godot AI, the new open source project from the makers of MCP for Unity.

Create your Unity apps with LLMs. MCP for Unity bridges AI assistants — Claude, Codex, VS Code, local LLMs, and more — with your Unity Editor via Model Context Protocol. Give your LLM the tools to manage assets, control scenes, edit scripts, run tests, and automate your game dev workflows.

MCP for Unity building a scene


Recent Updates

Full history: Release Notes.


What it does

Control the Unity Editor in natural language from any MCP client — create scenes & GameObjects, edit C# scripts, manage assets, run tests, profile, and build. 47 focused MCP tool entrypoints, any client, free & MIT.

Browse the full tool catalog →


Quickstart

Requirements: Unity 2021.3 LTS → 6.x · Python 3.10+ (via uv). Works with any MCP client — Claude Desktop & Code, Cursor, VS Code, Windsurf, Cline, Gemini CLI, and more.

  1. Install — Unity → Package Manager → Add from git URL: https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main  (pin #v10.0.0 for this release, or openupm add com.coplaydev.unity-mcp)
  2. Configure — Window → MCP for Unity → Configure All Detected Clients.
  3. Prompt — "Create a cube at the origin and add a Rigidbody." The cube appears in seconds.

Community

Contributing

See CONTRIBUTING.md. Branch off beta, not main. The full dev setup, testing, and release process live in the Contributing docs.

Advanced

Star History

Star History Chart

Citation

If MCP for Unity helped your research, please cite it.

@inproceedings{wu2025mcpunity,
  author    = {Wu, Shutong and Barnett, Justin P.},
  title     = {{MCP-Unity}: {Protocol-Driven} Framework for Interactive {3D} Authoring},
  year      = {2025},
  isbn      = {9798400721366},
  publisher = {Association for Computing Machinery},
  address   = {New York, NY, USA},
  url       = {https://doi.org/10.1145/3757376.3771417},
  doi       = {10.1145/3757376.3771417},
  series    = {SA Technical Communications '25}
}

Unity AI Tools by Aura

Aura offers 2 AI tools for Unity:

Disclaimer

This project is a free and open-source tool for the Unity Editor, and is not affiliated with Unity Technologies.


License: MIT — see LICENSE.

unity-mcp (CoplayDev/unity-mcp)

Searching Database…

What is this?It is MCP for Unity, an open-source bridge that connects AI assistants like Claude or Cursor to your Unity Editor, so the LLM can manage assets, control scenes, edit scripts, and automate game dev work.
So is it a plugin inside Unity or a separate app?Both halves of one bridge: a package you install inside the Unity Editor, plus an MCP server that exposes 47 focused tool entrypoints your AI assistant can call.
How do I get it running?Add the package from a git URL in Unity's Package Manager (or run openupm add com.coplaydev.unity-mcp), then open Window → MCP for Unity → Configure All Detected Clients.
What do I need installed before it works?Unity 2021.3 LTS through Unity 6.x, plus Python 3.10+ which the setup manages via uv.
Any install pitfalls to watch for?When adding the git URL, pin a release tag like #v10.0.0 to get a stable version; the openupm route installs a fixed package instead.
Which AI assistants can I plug into it?Any MCP client works — Claude Desktop and Claude Code, Cursor, VS Code, Windsurf, Cline, Gemini CLI, and more.
Is it free, or is there a paid tier?Completely free under the MIT license. The README also notes the project is not affiliated with Unity Technologies.
What can the AI actually do inside the editor?Create scenes and GameObjects, edit C# scripts, manage assets, run tests, profile, and build — 47 focused tool entrypoints in total.
I keep several Unity projects open at once — is that supported?Yes, multi-instance routing is a documented advanced feature for working with multiple Unity instances.
Can it validate the C# scripts the AI produces?Yes — Roslyn script validation is a documented advanced feature, and tool groups let you scope access to areas like vfx, animation, ui, and testing.
Is this the same thing as the paid Aura assistant?No — MCP for Unity is free and MIT-licensed. Aura for Unity is a separate premium AI assistant for Unity and Unreal from the same team.
Creator
CoplayDev
Size
44.9 MB
Stars
15K
Age
1y
Commits · 90 Days