MCP Unity Server for the Unity Editor: Setup for Claude, Cursor and Other Apps

• Lists every object in the open scenes

  Returns the tree of objects in the scenes you have open, so the assistant can see what is there.

  Try: “What objects are in my current scene?”

  Read · get_scenes_hierarchy

• Shows one object and its components

  Looks up one object and returns its components and the objects under it, to a depth you can limit.

  Try: “Show me the Player object and its components.”

  Read · get_gameobject

• Shows the active scene and loaded scenes

  Reports which scene is active, whether it has unsaved changes, and which other scenes are loaded.

  Try: “Which scene is open and does it have unsaved changes?”

  Read · get_scene_info

• Reads the Unity console messages

  Returns console entries a page at a time so a long log does not overflow the chat.

  Try: “Show the latest errors in the Unity console.”

  Read · get_console_logs

• Shows a material's shader and settings

  Returns the shader and every property value of one material.

  Try: “What are the settings of the Ground material?”

  Read · get_material_info

• Tells whether the game is playing or paused

  Reports if the editor is in play mode and whether it is paused.

  Try: “Is the game running?”

  Read · get_play_mode_status

• Changes an object's name, tag, layer or state, or creates it

  Edits core properties such as name, tag, layer and active or static state. If no object exists at the path, it creates one.

  Try: “Rename Cube to Crate and set its tag to Pickup.”

  Write · update_gameobject

• Changes a component's fields or adds the component

  Sets field values on a component of an object, and adds the component first if the object does not have it.

  Try: “Add a Rigidbody to Crate and set its mass to 5.”

  Write · update_component

• Selects an object in the editor

  Highlights an object in the hierarchy so you can see it.

  Try: “Select the Main Camera.”

  Write · select_gameobject

• Makes copies of an object

  Copies an object one or more times, with optional new names or a new parent.

  Try: “Duplicate the Tree object 10 times.”

  Write · duplicate_gameobject

• Deletes an object from the scene

  Removes an object from the open scene, and by default everything under it.

  Try: “Delete the old Spawner object.”

  Delete · delete_gameobject

• Moves an object under a different parent

  Changes where an object sits in the hierarchy.

  Try: “Move Lamp under the Room object.”

  Write · reparent_gameobject

• Moves an object to a new position

  Sets or shifts an object's position.

  Try: “Move the Crate 2 units up.”

  Write · move_gameobject

• Rotates an object

  Sets or adds to an object's rotation.

  Try: “Rotate the door 90 degrees on Y.”

  Write · rotate_gameobject

• Resizes an object

  Sets or multiplies an object's scale.

  Try: “Make the Rock twice as big.”

  Write · scale_gameobject

• Sets position, rotation and scale at once

  Changes any mix of position, rotation and scale in a single step.

  Try: “Put the Crate at 0,1,0 with no rotation and scale 1.”

  Write · set_transform

• Creates and saves a new scene

  Makes a new scene file at the path you give.

  Try: “Create a scene called Level2 in Assets/Scenes.”

  Write · create_scene

• Opens a scene

  Opens a scene, replacing the current one or adding to it.

  Try: “Load the MainMenu scene.”

  Write · load_scene

• Saves the current scene

  Writes the open scene to disk, or to a new file.

  Try: “Save the scene.”

  Write · save_scene

• Closes a scene without deleting it

  Removes a scene from the hierarchy but keeps its file.

  Try: “Unload the Test scene.”

  Write · unload_scene

• Deletes a scene file

  Removes a scene asset from the project and from the build list.

  Try: “Delete the old Prototype scene.”

  Delete · delete_scene

• Puts an asset from the project into the scene

  Places a prefab or other asset into the open scene.

  Try: “Add the Enemy prefab at the origin.”

  Write · add_asset_to_scene

• Creates a prefab, optionally with a script

  Builds a prefab asset and can attach a script with starting values.

  Try: “Create a Coin prefab with the Collectible script.”

  Write · create_prefab

• Creates a material

  Makes a material asset with a shader and color you choose.

  Try: “Create a red material called Danger.”

  Write · create_material

• Applies a material to an object

  Puts a material on an object in a given slot.

  Try: “Apply Danger to the Crate.”

  Write · assign_material

• Edits a material's colors, numbers or textures

  Changes values on a material, such as color, metallic or the main texture.

  Try: “Make the Ground material less shiny.”

  Write · modify_material

• Starts, pauses, stops or steps the game

  Presses the play controls in the editor.

  Try: “Start play mode.”

  Runs code · set_play_mode_status

• Recompiles all scripts

  Triggers a script recompile, for example after the assistant edits code.

  Try: “Recompile the scripts and tell me if there are errors.”

  Runs code · recompile_scripts

• Runs the Unity Test Runner

  Runs your project's tests and returns the results. Test code runs inside the editor.

  Try: “Run all EditMode tests.”

  Runs code · run_tests

• Runs a Unity menu item

  Clicks any menu item in the editor by its path, including ones your project adds, so what happens depends on the item.

  Try: “Run Assets > Refresh.”

  Runs code · execute_menu_item

• Writes a message to the Unity console

  Prints a line in the editor console.

  Try: “Log "build check done" to the console.”

  Write · send_console_log

• Installs a Unity package

  Installs a package, which can run editor code as it compiles. It is off until you turn on Allow Package Installation in the MCP Unity window.

  Try: “Install the Cinemachine package.”

  Runs code · add_package

• Runs several tool calls in one request

  Groups many tool calls into one step, and can undo them if one fails. It can run any of the other tools, including deletes.

  Try: “Create ten cubes in a row in one batch.”

  Delete · batch_execute

• Opens the Unity dashboard in VS Code

  Shows a dashboard panel inside VS Code. It needs VS Code 1.109 or later.

  Try: “Show the Unity dashboard.”

  Runs code · show_unity_dashboard

Watch out for

• It can delete objects and scene files

  delete_gameobject removes an object and its children, and delete_scene removes a scene file and its Build Settings entry. Keep your project in version control and commit before an editing session. github.com

• It can run menu items, tests and batches

  execute_menu_item can click any editor menu entry, run_tests runs project test code, and batch_execute groups many calls and can include deletes. Treat them as running code in your editor. github.com

• Package installation is opt-in

  add_package is off by default because packages can run editor code when they compile. Leave Allow Package Installation off unless you need it. github.com

• Remote connections open the editor to your network

  The Unity side listens on localhost by default. The Allow Remote Connections option binds it to every network interface, so use it only on a network you trust. github.com

Security advisories