Unity MCP Server

v1.5.2Developer Toolsstable

Unity MCP Server — 268 tools for AI-assisted game development. Connect Claude, Cursor, or any MCP client to Unity Editor & Unity Hub. Scene management, GameObjects, components, builds, profiling, Shader Graph, Amplify, terrain, physics, NavMesh, anim

aiai-integrationanthropicclaudecopilot
Share:
9,861
Stars
0
Downloads
0
Weekly
0/5

What is Unity MCP Server?

Unity MCP Server is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to unity mcp server — 268 tools for ai-assisted game development. connect claude, cursor, or any mcp client to unity editor & unity hub. scene management, gameobjects, components, builds, profiling, shad...

Unity MCP Server — 268 tools for AI-assisted game development. Connect Claude, Cursor, or any MCP client to Unity Editor & Unity Hub. Scene management, GameObjects, components, builds, profiling, Shader Graph, Amplify, terrain, physics, NavMesh, anim

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Unity MCP Server — 268 tools for AI-assisted game developmen

Use Cases

Game development integration
Scene management
Build automation
CoplayDev

Maintainer

LicenseMIT
Languagec#
Versionv1.5.2
UpdatedMay 22, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y unity-mcp-server

Manual Installation

npx -y unity-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Unity MCP Server

Unity MCP Server provides over 268 tools that connect AI assistants (Claude, Cursor, Codex, VS Code, and local LLMs) directly to the Unity Editor and Unity Hub for AI-assisted game development. It enables managing scenes, GameObjects, components, scripts, assets, builds, terrain, physics, NavMesh, animations, Shader Graph, profiling, and more — all through natural-language commands from your AI client. Game developers use it to automate repetitive Unity workflows, generate boilerplate code, and iterate on scenes without switching windows.

Prerequisites

  • Unity Editor installed (2021 LTS or newer recommended)
  • Python 3.10+ installed on your system
  • Claude Desktop, Cursor, VS Code, or another MCP-compatible AI client
  • Git or Unity Package Manager access to install the package
1

Install the Unity package via Package Manager

Open Unity, go to Window > Package Manager, click the + button, choose 'Add package from git URL', and paste the repository URL.

https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main
2

Configure detected AI clients from Unity

After installation, open Window > MCP for Unity > Configure All Detected Clients. The tool auto-detects installed AI clients and writes the necessary config entries.

3

Add the MCP server to your AI client manually (if needed)

If auto-detection does not configure your client, add the server block manually to your Claude Desktop or Cursor config.

{
  "mcpServers": {
    "unity-mcp-server": {
      "command": "npx",
      "args": ["-y", "unity-mcp-server"]
    }
  }
}
4

Verify the connection in Unity

With both Unity Editor and your AI client running, check the MCP for Unity panel (Window > MCP for Unity) to confirm the client connection is active.

5

Enable beta features (optional)

For access to beta tools including advanced VFX, animation, and UI tool groups, change the package URL to use the #beta branch instead of #main.

https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#beta

Unity MCP Server Examples

Client configuration

Claude Desktop config for the Unity MCP Server npm package.

{
  "mcpServers": {
    "unity-mcp-server": {
      "command": "npx",
      "args": ["-y", "unity-mcp-server"]
    }
  }
}

Prompts to try

Use these prompts in Claude or Cursor with the Unity MCP Server connected and Unity Editor open.

- "Create a red, blue, and yellow cube in the current scene"
- "Add a Rigidbody component to the Player GameObject"
- "Create a new C# script called PlayerMovement and attach it to the Player"
- "Build the project for Windows x64 and save to the Builds folder"
- "List all GameObjects in the current scene"

Troubleshooting Unity MCP Server

Package Manager fails to fetch the git URL

Ensure Git is installed and accessible on your PATH (git --version). Unity Package Manager uses the system Git binary. Also check that your firewall allows connections to github.com.

AI client shows the server as disconnected

Ensure Unity Editor is open and the MCP for Unity package is loaded — the server only runs while Unity is active. Restart both Unity and your AI client and re-check the MCP for Unity panel for connection status.

Python 3.10+ not found error during server startup

Install Python 3.10 or newer and ensure it is on your PATH (python3 --version). On macOS, install via Homebrew: brew install [email protected]. The server requires Python to bridge the Unity Editor communication.

Frequently Asked Questions about Unity MCP Server

What is Unity MCP Server?

Unity MCP Server is a Model Context Protocol (MCP) server that unity mcp server — 268 tools for ai-assisted game development. connect claude, cursor, or any mcp client to unity editor & unity hub. scene management, gameobjects, components, builds, profiling, shader graph, amplify, terrain, physics, navmesh, anim It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Unity MCP Server?

Install via npm with the command: npx -y unity-mcp-server. 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 Server?

Unity MCP Server works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Unity MCP Server free to use?

Yes, Unity MCP Server is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

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.

Quick Config Preview

{ "mcpServers": { "unity-mcp-server": { "command": "npx", "args": ["-y", "unity-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Unity MCP Server?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides