Unity MCP server
Commit Oct 30, 2026Lets an AI client control the Unity Editor to create scenes, edit C# scripts, manage assets, run tests, profile, and build.
Also known as CoplayDev/unity-mcp
- Stars
- 15,941
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Oct 30, 2026
- License
- MIT
What is Unity MCP?
Unity is an MCP server. Lets an AI client control the Unity Editor to create scenes, edit C# scripts, manage assets, run tests, profile, and build.
Summary generated from the project's README
About Unity MCP server
Driving the Unity Editor from an AI assistant is the job unity-mcp handles: it connects Unity to any MCP client so an LLM can create scenes and GameObjects, edit C# scripts, manage assets, run tests, profile, and build. It suits game developers who already work in Unity 2021.3 LTS through 6.x and want to make editor changes by describing them in natural language instead of clicking through menus.
Installation happens inside Unity through the Package Manager, adding the package from its git URL or via openupm, and then the editor window's "Configure All Detected Clients" step writes the client configuration. Python 3.10 or newer, provided through uv, is required. The project states it works with Claude Desktop and Code, Cursor, VS Code, Windsurf, Cline, Gemini CLI, and local LLMs, and a remote-hosted server option with authentication is documented.
The project advertises 50 focused MCP tool entrypoints, grouped into tool sets such as vfx, animation, ui, and testing, with routing for multiple Unity instances at once. Roslyn script validation is available for checking generated C#. It is free and MIT-licensed and is not affiliated with Unity Technologies.
What you can do with it
- 1Create starting scene objectsAsk the client to place a cube at the origin with a Rigidbody attached so the object appears in the open editor within seconds.
- 2Edit C# scripts with validationHave the assistant write or change gameplay scripts and check them through Roslyn validation before they reach the editor.
- 3Run tests and profile buildsTell the client to execute the project's tests and capture profiling data or a build from the open Unity Editor.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 13, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packageNot checked
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledNot checked
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesNot checked
README
View on GitHubProudly sponsored and maintained by Aura — the AI assistant for Unreal & Unity.
Now you can automate playtesting with Autopilot, the new open-source game tester.
- v10.3.0 (2026-10-04)
- v10.2.0 (2026-09-01)
- v10.1.2 (2026-08-02)
- v10.1.0 (2026-07-13)
- v10.0.2 (2026-07-13)
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. 50 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.
- Install — Unity → Package Manager → Add from git URL:
https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main(pin#v10.0.0for this release, oropenupm add com.coplaydev.unity-mcp) - Configure —
Window → MCP for Unity → Configure All Detected Clients. - Prompt — "Create a cube at the origin and add a Rigidbody." The cube appears in seconds.
Community
- Discord — chat with maintainers and other contributors
- Issues — bugs and feature requests
- Discussions — design ideas and broader questions
- Security: see SECURITY.md for private reporting
Contributing
See CONTRIBUTING.md. Branch off beta, not main. The full dev setup, testing, and release process live in the Contributing docs.
Advanced
- Multiple Unity instances — Multi-Instance Routing
- Tool groups (vfx / animation / ui / testing / etc.) — Tool Groups
- v10 asset generation and upgrade notes — v10 Migration
- Roslyn script validation — Roslyn Validation
- Remote-hosted server with auth — Remote Server Auth
Star History
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:
- MCP for Unity is available freely under the MIT license.
- Aura for Unity is a premium Unity/Unreal AI assistant built for game devs.
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 questions
Which Unity versions does MCP for Unity support?
It supports Unity 2021.3 LTS through 6.x, and requires Python 3.10+ via uv.
Which MCP clients work with MCP for Unity?
It works with any MCP client, including Claude Desktop and Code, Cursor, VS Code, Windsurf, Cline, and Gemini CLI.
How do I install MCP for Unity?
Add the package in Unity's Package Manager from the git URL, then run Configure All Detected Clients from the MCP for Unity window.
What can an AI assistant do with the Unity MCP server?
It can create scenes and GameObjects, edit C# scripts, manage assets, run tests, profile, and build, using about 50 MCP tools.
Can I connect multiple Unity instances at once?
Yes, multi-instance routing is documented in the Advanced guides.