mcp-unity

Overview

MCP Unity is a comprehensive Model Context Protocol implementation that bridges Unity Editor with AI coding assistants. It provides extensive tools for manipulating Unity scenes, GameObject properties, components, materials, and packages. The server supports both tool-based operations and resources-based queries, enabling bidirectional communication between AI agents and Unity projects. Its IDE integration features improve code intelligence for Unity packages by adding Library/PackedCache to workspace contexts.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• execute_menu_item

  Executes Unity menu items (functions tagged with the MenuItem attribute)

  Try:Execute the menu item 'GameObject/Create Empty' to create a new empty GameObject
• select_gameobject

  Selects game objects in the Unity hierarchy by path or instance ID

  Try:Select the Main Camera object in my scene
• update_gameobject

  Updates a GameObject's core properties or creates the GameObject if it does not exist

  Try:Set the Player object's tag to 'Enemy' and make it inactive
• update_component

  Updates component fields on a GameObject or adds it to the GameObject if it does not contain the component

  Try:Add a Rigidbody component to the Player object and set its mass to 5
• add_package

  Installs new packages in the Unity Package Manager

  Try:Add the TextMeshPro package to my project
• run_tests

  Runs tests using the Unity Test Runner

  Try:Run all the EditMode tests in my project
• get_gameobject

  Gets detailed information about a specific GameObject including all components

  Try:Get the details of the Player GameObject
• get_console_logs

  Retrieves logs from the Unity console with pagination support

  Try:Show me the last 20 error logs from the Unity console
• save_scene

  Saves the current active scene, with optional Save As to a new path

  Try:Save the current sceneTry:Save the scene as 'Assets/Scenes/Level2.unity'
• duplicate_gameobject

  Duplicates a GameObject in the scene with optional renaming and reparenting

  Try:Duplicate the Enemy prefab 5 times and rename them Enemy_1 through Enemy_5
• move_gameobject

  Moves a GameObject to a new position (local or world space)

  Try:Move the Player object to position (10, 0, 5) in world space
• batch_execute

  Executes multiple tool operations in a single batch request

  Try:Create 10 empty GameObjects named Enemy_1 through Enemy_10 in a single batch operation

Comparable tools

Installation

{
  "mcpServers": {
    "unity": {
      "command": "npx",
      "args": ["@codergamester/mcp-unity"],
      "env": {
        "UNITY_PROJECT_PATH": "/path/to/your/unity/project"
      }
    }
  }
}

FAQ

Which Unity versions are supported?

MCP Unity supports Unity 6 or later versions.

What IDEs are compatible with MCP Unity?

It's designed for Cursor, Claude Code, Codex, Windsurf and other VSCode-like IDEs with MCP support.

Compare mcp-unity with