unity-mcp-server

Control Unity Editor and Unity Hub from AI assistants via MCP tools.

7|2|Updated May 16, 2026
One-click install
npx skills add https://github.com/reason-machines/mcp-skills --skill unity-mcp-server-reason-machines
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unity-mcp-server
Source: https://github.com/reason-machines/mcp-skills/tree/main/skills/unity-mcp-server
Command: npx skills add https://github.com/reason-machines/mcp-skills --skill unity-mcp-server-reason-machines

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Game developers cannot directly drive Unity Editor actions—scene editing, GameObject creation, builds, profiling—from AI assistants, forcing manual repetition of editor workflows that could be automated. ## Core Features & Use Cases - Scene and GameObject Automation: Create scenes, spawn primitives, set transforms, reparent objects, and wire component references through 288 MCP tools across 30+ categories. - Builds, Tests, and Profiling: Trigger multi-platform builds (Windows, macOS, Linux, Android, iOS, WebGL), run EditMode/PlayMode tests, and capture profiler and memory stats. - Advanced Editor Features via Proxy: Access terrain sculpting, NavMesh baking, Shader Graph editing, and scene view capture through the unity_advanced_tool lazy-loaded proxy. - Use Case: Ask your AI assistant to scaffold a game level: it creates a scene, adds a terrain, spawns a player capsule with a Rigidbody and a generated PlayerController script, assigns materials to enemies, wires references, and saves the scene. ## Quick Start Install the Unity plugin from the git URL in Package Manager, configure the MCP server in Claude Desktop or Cursor with your Unity Hub path, then ask your assistant to create a new Unity scene with a red cube and a Rigidbody component.

Frequently Asked Questions about unity-mcp-server

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I control Unity Editor from Claude or Cursor?▼

Install the unity-mcp-plugin package in Unity via Package Manager git URL, then run the Node.js MCP server and register it in your Claude Desktop or Cursor MCP configuration. The assistant can then call tools like unity_create_gameobject and unity_build.

How to automate Unity builds for multiple platforms with MCP?▼

Call the unity_build tool with a target such as StandaloneWindows64, StandaloneOSX, Android, iOS, or WebGL and an output path. The server forwards the build request to the Unity Editor plugin over the HTTP bridge.

Does unity-mcp-server work with multiple Unity Editor instances?▼

Yes, the server scans ports 7890-7899 on startup to discover running instances, including ParrelSync clones. Use unity_list_instances to see them and unity_switch_instance to change the active connection.

Why is the MCP server not connecting to Unity Editor?▼

Verify the plugin's HTTP server is running via Window > MCP Dashboard and that the port matches UNITY_BRIDGE_PORT. Check port availability with lsof or netstat, and set UNITY_MCP_DEBUG=true for detailed logs.

What are the limitations of unity-mcp-server responses?▼

Responses are capped at a 2MB soft limit and 4MB hard limit, so large scene hierarchies may be truncated. Use pagination parameters on unity_get_scene_hierarchy and batch operations to stay within limits.