Skip to main content
Glama
Sign In
Unity MCP Server

Unity MCP Server

by Seoki2000
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Local

Unity MCP Server ๐Ÿš€

Unity 2021.3+ License: MIT MCP

Read this in other languages: ํ•œ๊ตญ์–ด A Model Context Protocol (MCP) server for Unity that enables AI agents to query and control the Unity Editor. This local-optimized version is enhanced with additional tools for Behavior Trees, Window Management, and advanced GameObject/Hierarchy manipulation.

What is MCP?

MCP is an open standard by Anthropic that allows AI systems to access external tools and data. This package turns Unity into an MCP server, letting AI assistants like Antigravity, Claude, and Cursor seamlessly query your scenes, modify assets, and execute editor commands.

Related MCP server: Funplay MCP for Unity

Key Features

  • ๐ŸŽฎ Scene & Hierarchy Control: Create, modify, set parents, and find objects by component.

  • ๐Ÿงฉ Component Management: Add, remove, and deeply inspect serialized component properties.

  • ๐ŸŒฒ Behavior Tree Tools (New): Manage Unity Behavior graphs (add/remove nodes, connect, set properties).

  • ๐ŸชŸ Window Management (New): Directly open Editor windows like Animator or Behavior graph.

  • ๐ŸŽฌ Scene & Prefab Management: Open, save scenes, instantiate and unpack prefabs.

  • ๐Ÿ“ฆ Asset & Resource Access: Browse, move, duplicate, and read project assets.

  • โ–ถ๏ธ Play Mode & Input: Control play mode state and simulate inputs.

Installation (Via Git URL)

  1. Open Window > Package Manager in Unity.

  2. Click the + icon in the top left and select Add package from git URL....

  3. Enter the repository URL (or local path if you are using a local clone):

    https://github.com/usmanbutt-dev/unity-mcp.git

Quick Start

  1. The server auto-starts when the Unity project is loaded.

  2. Navigate to Window > MCP Server to view the server status.

  3. Click "Copy Config to Clipboard".

  4. Paste the configuration into your MCP client's configuration file (e.g., mcp_config.json).

Available Tools (Expanded)

๐Ÿงฉ GameObject & Component Tools

Tool

Description

unity_create_gameobject

Create new GameObjects (primitives supported).

unity_delete_gameobject

Delete GameObjects from the scene.

unity_set_transform

Modify position, rotation, and scale.

unity_add_component

Add a component to a GameObject.

unity_remove_component

Remove a component from a GameObject.

unity_set_component_property

Set a specific component property value.

unity_get_component_properties

[NEW] Get all serialized properties and values of a component.

๐ŸŒฒ Hierarchy Tools

Tool

Description

unity_get_hierarchy

Retrieve the scene's GameObject hierarchy.

unity_get_gameobject

Get details of a specific GameObject.

unity_get_components

List components attached to a GameObject.

unity_find_objects_by_component

[NEW] Find all GameObjects in the active scene that have a specific component.

unity_set_object_parent

[NEW] Reparent a GameObject to another GameObject.

๐Ÿง  Behavior Tree Tools (NEW)

Tool

Description

unity_get_bt_graph

Get details of a Behavior Graph (nodes, edges, blackboard).

unity_add_bt_node

Add a new node to a Behavior Graph.

unity_remove_bt_node

Remove a node from a Behavior Graph.

unity_connect_bt_nodes

Connect two nodes in a Behavior Graph.

unity_set_bt_node_property

Set a property value on a Behavior Graph node.

๐ŸชŸ Window Management (NEW)

Tool

Description

unity_open_animator_window

Open the Animator window in the Unity Editor.

unity_open_bt_window

Open the Unity Behavior (BT) window.

๐Ÿƒ Animation Tools

Tool

Description

unity_set_animator_parameter

Set bool/float/int/trigger parameters.

unity_get_animator_info

Get animator state, parameters, and layers.

unity_play_animation

Play animation state by name.

unity_set_animator_culling_mode

[NEW] Set the culling mode of an Animator.

(Other standard tools for Play Mode, Scene Management, Physics, Assets, Materials, and Shaders are fully supported as part of the core MCP feature set!)

Example Prompts for AI

Once connected, try asking your AI assistant:

  • "Find all GameObjects with the EnemyController component."

  • "Open the Behavior Tree window."

  • "Set the parent of Weapon to Player/RightHand."

  • "Get all component properties for the Rigidbody on the Player."

  • "Create a red cube at position (0, 2, 0)."

Requirements

  • Unity 2021.3 or later

  • Node.js (Required for the MCP bridge mcp-bridge.js)

License

MIT License - see LICENSE

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelogโ€ฆ

    This server cannot be deployed

    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Unity x Claude MCP Server

      matthewagi
      A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that provides 20 tools to control the Unity Editor with natural language, including scene management, component manipulation, script generation, asset handling, project settings, builds, and live C# execution.
      2
      MIT
    • Funplay MCP for Unity

      Funplay MCP for Unityofficial

      FunplayAI
      A
      license
      Not graded
      quality
      A
      maintenance
      This MCP server integrates AI assistants with Unity Editor, allowing them to create scenes, generate scripts, simulate input, and automate workflows using 91 built-in tools.
      287
      MIT