Unity MCP
A Model Context Protocol server that integrates AI assistants like Claude and Cursor directly into the Unity Editor to automate game development workflows. It provides over 40 built-in tools for scene manipulation and project management, while offeri
What is Unity MCP?
Unity MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol server that integrates ai assistants like claude and cursor directly into the unity editor to automate game development workflows. it provides over 40 built-in tools for scene m...
A Model Context Protocol server that integrates AI assistants like Claude and Cursor directly into the Unity Editor to automate game development workflows. It provides over 40 built-in tools for scene manipulation and project management, while offeri
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Model Context Protocol server that integrates AI assistant
Use Cases
Maintainer
Works with
Installation
NPM
npx -y unity-mcp-cliManual Installation
npx -y unity-mcp-cliConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Unity MCP
Unity-MCP is a Model Context Protocol integration that embeds AI assistants — including Claude and Cursor — directly inside the Unity Editor to automate game development tasks. It provides 70+ built-in tools covering scene manipulation, asset management, C# script generation, dynamic code compilation, profiling, and unit test execution, all without leaving the editor. Game developers use it to offload repetitive Unity workflows to AI: creating GameObjects, wiring components, debugging console errors, and analyzing render performance through natural language commands.
Prerequisites
- Unity Editor 2021.3 LTS or newer (the Unity-MCP plugin must be installed in your project)
- Node.js 18+ for the unity-mcp-cli npm package
- An MCP client such as Claude Desktop, Claude Code, or Cursor
- The Unity project path must not contain spaces
- Optional: a GitHub Personal Access Token for OpenUPM package installation
Install the npm CLI tool
Install the unity-mcp-cli package globally. This CLI bridges your MCP client with the Unity Editor plugin via a local server.
npm install -g unity-mcp-cliInstall the Unity Editor plugin
Use the CLI to install the Unity-MCP plugin directly into your Unity project. This adds the C# server component that listens for MCP tool calls inside the Editor.
unity-mcp-cli install-plugin ./MyUnityProjectConfigure skills for Claude Code
If using Claude Code, run the setup-skills command to register Unity-MCP's capabilities as Claude Code skills for your project.
unity-mcp-cli setup-skills claude-code ./MyUnityProjectOpen Unity and verify the plugin
Open your Unity project. The Unity-MCP plugin should appear in the Editor's toolbar or menu. Confirm the MCP server is listening on port 8080 (default). The plugin starts automatically when the Editor opens.
Configure your MCP client
Add Unity-MCP to your Claude Desktop or Claude Code config. The server runs on localhost via streamableHttp by default, so point the MCP client to the local endpoint.
{
"mcpServers": {
"unity-mcp": {
"command": "npx",
"args": ["-y", "unity-mcp-cli"],
"env": {
"MCP_PLUGIN_PORT": "8080",
"MCP_PLUGIN_CLIENT_TRANSPORT": "streamableHttp"
}
}
}
}Start using AI in your Unity project
With the Editor open and the MCP client configured, ask your AI assistant to perform Unity tasks. The assistant will call the appropriate built-in tools to manipulate your scene or scripts.
Unity MCP Examples
Client configuration
MCP configuration for Claude Desktop connecting to the Unity Editor via unity-mcp-cli with default settings.
{
"mcpServers": {
"unity-mcp": {
"command": "npx",
"args": ["-y", "unity-mcp-cli"],
"env": {
"MCP_PLUGIN_PORT": "8080",
"MCP_PLUGIN_CLIENT_TRANSPORT": "streamableHttp",
"MCP_AUTHORIZATION": "none"
}
}
}
}Prompts to try
Natural language prompts that drive Unity Editor actions through the 70+ built-in tools.
- "Create 3 spheres stacked on top of each other in the scene"
- "Create a metallic golden material and attach it to the selected GameObject"
- "Explain the current scene hierarchy and list all GameObjects"
- "Show me the last 20 console errors and suggest fixes"
- "Run all unit tests in the project and report failures"
- "Profile the current frame and identify the top 3 rendering bottlenecks"Troubleshooting Unity MCP
MCP client can't connect to Unity — 'connection refused' on port 8080
Ensure Unity is open with the project loaded and the Unity-MCP plugin is active. Check Window > Unity-MCP in the Unity menu to confirm the server is running. If the port is in use, set the MCP_PLUGIN_PORT environment variable to a free port in both the plugin settings and the MCP client config.
unity-mcp-cli install-plugin fails with a path error
Unity project paths containing spaces are not supported. Move your project to a path with no spaces (e.g., /Users/username/Projects/MyGame) and re-run the install command.
AI assistant reports tools are unavailable after configuration
Restart both the MCP client and Unity Editor after installation. The C# plugin needs to compile on first run, which can take 30–60 seconds. Check the Unity console for any compilation errors in the Unity-MCP namespace.
Frequently Asked Questions about Unity MCP
What is Unity MCP?
Unity MCP is a Model Context Protocol (MCP) server that model context protocol server that integrates ai assistants like claude and cursor directly into the unity editor to automate game development workflows. it provides over 40 built-in tools for scene manipulation and project management, while offeri It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Unity MCP?
Install via npm with the command: npx -y unity-mcp-cli. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Unity MCP?
Unity MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Unity MCP free to use?
Yes, Unity MCP is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
Unity MCP Alternatives — Similar Developer Tools Servers
Looking for alternatives to Unity MCP? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Unity MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Unity MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.