Unity MCP Server
Allows AI agents to query and control the Unity Editor, including scene hierarchy, GameObjects, components, prefabs, assets, scenes, console, editor state, play mode, input simulation, animations, materials, physics, and asset creation.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Unity MCP Servershow me the scene hierarchy"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Unity MCP Server 🚀
Read this in other languages: 한국어 A Model Context Protocol (MCP) server for Unity that enables AI agents to query and control the Unity Editor. This local-optimized version is enhanced with additional tools for Behavior Trees, Window Management, and advanced GameObject/Hierarchy manipulation.
What is MCP?
MCP is an open standard by Anthropic that allows AI systems to access external tools and data. This package turns Unity into an MCP server, letting AI assistants like Antigravity, Claude, and Cursor seamlessly query your scenes, modify assets, and execute editor commands.
Related MCP server: Funplay MCP for Unity
Key Features
🎮 Scene & Hierarchy Control: Create, modify, set parents, and find objects by component.
🧩 Component Management: Add, remove, and deeply inspect serialized component properties.
🌲 Behavior Tree Tools (New): Manage Unity Behavior graphs (add/remove nodes, connect, set properties).
🪟 Window Management (New): Directly open Editor windows like Animator or Behavior graph.
🎬 Scene & Prefab Management: Open, save scenes, instantiate and unpack prefabs.
📦 Asset & Resource Access: Browse, move, duplicate, and read project assets.
▶️ Play Mode & Input: Control play mode state and simulate inputs.
Installation (Via Git URL)
Open
Window > Package Managerin Unity.Click the
+icon in the top left and selectAdd package from git URL....Enter the repository URL (or local path if you are using a local clone):
https://github.com/usmanbutt-dev/unity-mcp.git
Quick Start
The server auto-starts when the Unity project is loaded.
Navigate to
Window > MCP Serverto view the server status.Click "Copy Config to Clipboard".
Paste the configuration into your MCP client's configuration file (e.g.,
mcp_config.json).
Available Tools (Expanded)
🧩 GameObject & Component Tools
Tool | Description |
| Create new GameObjects (primitives supported). |
| Delete GameObjects from the scene. |
| Modify position, rotation, and scale. |
| Add a component to a GameObject. |
| Remove a component from a GameObject. |
| Set a specific component property value. |
| [NEW] Get all serialized properties and values of a component. |
🌲 Hierarchy Tools
Tool | Description |
| Retrieve the scene's GameObject hierarchy. |
| Get details of a specific GameObject. |
| List components attached to a GameObject. |
| [NEW] Find all GameObjects in the active scene that have a specific component. |
| [NEW] Reparent a GameObject to another GameObject. |
🧠 Behavior Tree Tools (NEW)
Tool | Description |
| Get details of a Behavior Graph (nodes, edges, blackboard). |
| Add a new node to a Behavior Graph. |
| Remove a node from a Behavior Graph. |
| Connect two nodes in a Behavior Graph. |
| Set a property value on a Behavior Graph node. |
🪟 Window Management (NEW)
Tool | Description |
| Open the Animator window in the Unity Editor. |
| Open the Unity Behavior (BT) window. |
🏃 Animation Tools
Tool | Description |
| Set bool/float/int/trigger parameters. |
| Get animator state, parameters, and layers. |
| Play animation state by name. |
| [NEW] Set the culling mode of an Animator. |
(Other standard tools for Play Mode, Scene Management, Physics, Assets, Materials, and Shaders are fully supported as part of the core MCP feature set!)
Example Prompts for AI
Once connected, try asking your AI assistant:
"Find all GameObjects with the
EnemyControllercomponent.""Open the Behavior Tree window."
"Set the parent of
WeapontoPlayer/RightHand.""Get all component properties for the
Rigidbodyon the Player.""Create a red cube at position (0, 2, 0)."
Requirements
Unity 2021.3 or later
Node.js (Required for the MCP bridge
mcp-bridge.js)
License
MIT License - see LICENSE
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityDmaintenanceAn MCP server that provides 20 tools to control the Unity Editor with natural language, including scene management, component manipulation, script generation, asset handling, project settings, builds, and live C# execution.Last updated1MIT

Funplay MCP for Unityofficial
Alicense-qualityAmaintenanceThis MCP server integrates AI assistants with Unity Editor, allowing them to create scenes, generate scripts, simulate input, and automate workflows using 91 built-in tools.Last updated195MIT- Alicense-qualityAmaintenanceAn MCP server that enables AI agents to control the Unity Editor externally, providing tools for scene, GameObject, component, and other editor operations.Last updated1MIT
- Alicense-qualityBmaintenanceUnity MCP Server enables LLM-based clients to automate the Unity Editor, including scene manipulation, UI testing, input simulation, and code editing.Last updated34MIT
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
An MCP server that integrates with Discord to provide AI-powered features.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Seoki2000/unity-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server