MCP Unity MCP Server

The purpose of this package is to provide a MCP Unity Server for executing Unity operations and request Editor information from AI MCP enabled hosts

Local serverstdioTypeScript

What is the MCP Unity MCP Server?

The purpose of this package is to provide a MCP Unity Server for executing Unity operations and request Editor information from AI MCP enabled hosts

What it actually does

MCP Unity is an implementation of the Model Context Protocol for Unity Editor, allowing AI assistants to interact with your Unity projects. This package provides a bridge between Unity and a Node.js server that implements the MCP protocol, enabling AI agents like Cursor, Windsurf, Claude Code, Codex CLI, GitHub Copilot, Google Antigravity, and OpenCode to execute operations within the Unity Editor.

Configuration

  • Unity 6 or later - to install the server - Node.js 18 or later - to start the server - npm 9 or later - to debug the server > [!NOTE] > Project Paths with Spaces > > MCP Unity supports project paths containing spaces. However, if you experience connection issues, try moving your project to a path without spaces as a troubleshooting step.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
execute_menu_itemExecutes Unity menu items (functions tagged with the MenuItem attribute)
select_gameobjectSelects game objects in the Unity hierarchy by path or instance ID
update_gameobjectUpdates a GameObject's core properties (name, tag, layer, active/static state), or creates the GameObject if it does not exist
update_componentUpdates component fields on a GameObject or adds it to the GameObject if it does not contain the component
add_packageInstalls new packages in the Unity Package Manager
run_testsRuns tests using the Unity Test Runner
send_console_logSend a console log to Unity
add_asset_to_sceneAdds an asset from the AssetDatabase to the Unity scene
create_prefabCreates a prefab with optional MonoBehaviour script and serialized field values
create_sceneCreates a new scene and saves it to the specified path
load_sceneLoads a scene by path or name, with optional additive loading
delete_sceneDeletes a scene by path or name and removes it from Build Settings
get_gameobjectGets detailed information about a specific GameObject including all components
get_console_logsRetrieves logs from the Unity console with pagination support

How to install the MCP Unity MCP Server

{
  "mcpServers": {
    "mcp-unity": {
      "command": "node",
      "args": [
        "ABSOLUTE/PATH/TO/mcp-unity/Server~/build/index.js"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Unity 6 or later - to install the server - Node.js 18 or later - to start the server - npm 9 or later - to debug the server > [!NOTE] > Project Paths with Spaces > > MCP Unity supports project paths containing spaces. However, if you experience connection issues, try moving your project to a path without spaces as a troubleshooting step.

Example prompts to try

  • “Use MCP Unity to execute menu item.”
  • “Use MCP Unity to select gameobject.”
  • “Use MCP Unity to update gameobject.”

Frequently asked questions

The purpose of this package is to provide a MCP Unity Server for executing Unity operations and request Editor information from AI MCP enabled hosts Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.