Supports Claude Code, Codex, Cursor, Windsurf, Mcp

• ✔️ AI agents - Use the best agents from Anthropic, OpenAI, Microsoft, or any other provider with no vendor lock-in
• ✔️ Tools - A wide range of default MCP Tools for operating in Unity Editor
• ✔️ Skills - Generate skills for AI based on operating system, Unity version, plugins in the project
• ✔️ Code and Tests - Develop game mechanics and test them with AI agents
• ✔️ Runtime (in-game) - Use LLMs directly inside your compiled game for dynamic NPC behavior or debugging
• ✔️ Debug support - Let AI debug and fix the problems in a project
• ✔️ Natural conversation - Chat with AI like you would with a human
• ✔️ Flexible deployment - Works locally (stdio) and remotely (http) via configuration
• ✔️ Extensible - Create custom Tools in your project code

https://github.com/user-attachments/assets/228baf4d-4f00-4dce-939d-fb985ebdd8dd

OR use cli

# 1. Install unity-mcp-cli
npm install -g unity-mcp-cli

# 2. Install "AI Game Developer" in Unity project
unity-mcp-cli install-plugin ./MyUnityProject

# 3. Login to cloud server
unity-mcp-cli login ./MyUnityProject

# 4. Open Unity project (auto-connects and generates skills)
unity-mcp-cli open ./MyUnityProject

Quick Start

Get up and running in three steps:

1. Install plugin — download the .unitypackage installer or run openupm add com.ivanmurzak.unity.mcp

   Alternative: npx unity-mcp-cli install-plugin ./MyUnityProject — see CLI documentation

2. Pick an AI agent — Claude Code, Claude Desktop, GitHub Copilot, Cursor, or any other
3. Setup AI agent — open Window/AI Game Developer in Unity and click Auto-generate skills (recommended) or Configure MCP

   Alternative: npx unity-mcp-cli setup-skills claude-code ./MyUnityProject — see CLI documentation

That's it. Ask your AI "Create 3 cubes in a circle with radius 2" and watch it happen. ✨

Skills and Tools Reference

The plugin ships with 70+ built-in tools across four categories. Each tool brings AI skill. All tools are available immediately after installation — no extra configuration required. See docs/default-mcp-tools.md for the full reference with detailed descriptions.

🧰 Browse the full MCP tools registry online: ai-game.dev/docs/tools

• assets-copy - Copy the asset at path and stores it at newPath
• assets-create-folder - Creates a new folder in the specified parent folder
• assets-delete - Delete the assets at paths from the project
• assets-find - Search the asset database using the search filter string
• assets-find-built-in - Search the built-in assets of the Unity Editor
• assets-get-data - Get asset data from the asset file including all serializable fields and properties
• assets-material-create - Create new material asset with default parameters
• assets-modify - Modify asset file in the project
• assets-move - Move the assets at paths in the project (also used for rename)
• assets-prefab-close - Close currently opened prefab
• assets-prefab-create - Create a prefab from a GameObject in the current active scene
• assets-prefab-instantiate - Instantiates prefab in the current active scene
• assets-prefab-open - Open prefab edit mode for a specific GameObject
• assets-prefab-save - Save a prefab in prefab editing mode
• assets-refresh - Refreshes the AssetDatabase
• assets-shader-get-data - Get detailed data about a shader asset (properties, subshaders, passes)
• assets-shader-list-all - List all available shaders in the project assets and packages

• gameobject-component-add - Add Component to GameObject
• gameobject-component-destroy - Destroy one or many components from target GameObject
• gameobject-component-get - Get detailed information about a specific Component on a GameObject
• gameobject-component-list-all - List C# class names extended from UnityEngine.Component
• gameobject-component-modify - Modify a specific Component on a GameObject
• gameobject-create - Create a new GameObject in opened Prefab or in a Scene
• gameobject-destroy - Destroy GameObject and all nested GameObjects recursively
• gameobject-duplicate - Duplicate GameObjects in opened Prefab or in a Scene
• gameobject-find - Finds specific GameObject by provided information
• gameobject-modify - Modify GameObjects and/or attached component's fields and properties
• gameobject-set-parent - Set parent GameObject to list of GameObjects
• object-get-data - Get data of the specified Unity Object
• object-modify - Modify the specified Unity Object
• scene-create - Create new scene in the project assets
• scene-get-data - Retrieves the list of root GameObjects in the specified scene
• scene-list-opened - Returns the list of currently opened scenes in Unity Editor
• scene-open - Open scene from the project asset file

• console-clear-logs - Clears the MCP log cache and the Unity Editor Console window
• console-get-logs - Retrieves Unity Editor logs with filtering options
• editor-application-get-state - Returns information about the Unity Editor application state (playmode, paused, compilation)
• editor-application-set-state - Control the Unity Editor application state (start/stop/pause playmode)
• editor-selection-get - Get information about the current Selection in the Unity Editor
• editor-selection-set - Set the current Selection in the Unity Editor
• reflection-method-call - Call any C# method with input parameters and return results
• reflection-method-find - Find method in the project using C# Reflection (even private methods)
• script-delete - Delete the script file(s)
• script-execute - Compiles and executes C# code dynamically using Roslyn
• script-read - Reads the content of a script file
• script-update-or-create - Updates or creates script file with the provided C# code
• tests-run - Execute Unity tests (EditMode/PlayMode) with filtering and detailed results
• type-get-json-schema - Generate a JSON Schema for a C# type via reflection

• profiler-capture-frame - Capture the current frame's timing info (delta time, FPS, frame counts)
• profiler-clear-data - Discard all frames currently held by the Editor Profiler
• profiler-enable-module - Toggle the local enabled flag for a named profiler module
• profiler-get-memory-stats - Return a memory statistics snapshot (reserved, allocated, mono heap, graphics)
• profiler-get-rendering-stats - Return frame timing, FPS, vsync, target frame rate, graphics device type
• profiler-get-script-stats - Return script execution timing plus Mono / GC memory usage
• profiler-get-status - Return the profiler's enabled state, active modules, and platform support
• profiler-list-modules - List all known profiler module names with their enabled flag
• profiler-load-data - Read back a previously-saved profiler JSON snapshot
• profiler-save-data - Save a snapshot of profiler-derived stats to a JSON file
• profiler-start - Enable Unity's runtime profiler and open the Profiler window
• profiler-stop - Disable Unity's runtime profiler

[!IMPORTANT] Project path cannot contain spaces

• ✅ C:/MyProjects/MyProject
• ❌ C:/My Projects/MyProject
• ❌ C:/My Projects/My Project
• ❌ C:/MyProjects/My Project

Option 1 - Installer

• ⬇️ Download Installer
• 📂 Import installer into Unity project

  • You can double-click on the file - Unity will open it automatically
  • OR: Open Unity Editor first, then click on Assets/Import Package/Custom Package, and choose the file

Option 2 - CLI (recommended)

Install the plugin via unity-mcp-cli — no Unity Editor needed:

# 1.1 Install unity-mcp-cli                                #  ┌────────────────────┐
npm install -g unity-mcp-cli                               #  │ Available AI agent │
                                                           #  ├────────────────────┤
# 1.2 (Optional) Install Unity                             #  │ antigravity        │
unity-mcp-cli install-unity                                #  │ claude-code        │
                                                           #  │ claude-desktop     │
# 1.3 (Optional) Create Unity project                      #  │ cline              │
unity-mcp-cli create-project ./MyUnityProject              #  │ codex              │
                                                           #  │ cursor             │
# 2. Install "AI Game Developer" in Unity project          #  │ gemini             │
unity-mcp-cli install-plugin ./MyUnityProject              #  │ github-copilot-cli │
                                                           #  │ kilo-code          │
# 3. Login to cloud server                                 #  │ open-code          │
unity-mcp-cli login ./MyUnityProject                       #  │ rider-junie        │
                                                           #  │ unity-ai           │
# 4. Open Unity project (auto-connects and generates skills)  │ vs-copilot         │
unity-mcp-cli open ./MyUnityProject                        #  │ vscode-copilot     │
                                                           #  └────────────────────┘
# 5. Wait for Unity Editor to be ready
unity-mcp-cli wait-for-ready ./MyUnityProject

See full CLI documentation for all available commands.