MCP server for Unity Editor integration - enables AI assistants to control Unity Editor
npm install unity-editor-mcpMCP (Model Context Protocol) server for Unity Editor integration. Enables AI assistants like Claude and Cursor to interact directly with Unity Editor for automated game development.
- 33 comprehensive tools for Unity Editor automation
- GameObject management - Create, find, modify, delete GameObjects
- Scene management - Create, load, save, list scenes
- Scene analysis - Deep inspection and component analysis
- UI interactions - Find, click, and interact with UI elements
- Asset management - Create and modify prefabs and materials
- Play mode controls - Start, pause, stop Unity play mode
- System tools - Console logs, asset refresh, connection testing
``bash`
npx unity-editor-mcp
`bash`
npm install -g unity-editor-mcp
unity-editor-mcp
`bash`
npm install unity-editor-mcp
npx unity-editor-mcp
1. Install the Unity package from: https://github.com/ozankasikci/unity-mcp.git?path=unity-editor-mcp
2. Open Unity Package Manager → Add package from git URL
3. The package will automatically start a TCP server on port 6402
Add to your claude_desktop_config.json:
`json`
{
"mcpServers": {
"unity-editor-mcp": {
"command": "npx",
"args": ["unity-editor-mcp"]
}
}
}
`json`
{
"mcpServers": {
"unity-editor-mcp": {
"command": "unity-editor-mcp"
}
}
}
- Test Unity Editor connection
- read_logs - Read Unity console logs
- refresh_assets - Trigger asset recompilation$3
- create_gameobject - Create GameObjects with primitives and transforms
- find_gameobject - Find GameObjects by name, tag, layer
- modify_gameobject - Modify GameObject properties
- delete_gameobject - Delete GameObjects
- get_hierarchy - Get scene hierarchy$3
- create_scene - Create new scenes
- load_scene - Load scenes (Single/Additive)
- save_scene - Save current scene
- list_scenes - List project scenes
- get_scene_info - Get scene details$3
- get_gameobject_details - Deep GameObject inspection
- analyze_scene_contents - Scene statistics and analysis
- get_component_values - Component property inspection
- find_by_component - Find objects by component type
- get_object_references - Analyze object relationships$3
- play_game - Start Unity play mode
- pause_game - Pause/resume play mode
- stop_game - Stop play mode
- get_editor_state - Get editor state$3
- find_ui_elements - Find UI elements by type, tag, or name
- click_ui_element - Click on UI buttons and interactive elements
- get_ui_element_state - Get UI element properties and state
- set_ui_element_value - Set values for input fields and sliders
- simulate_ui_input - Simulate keyboard and mouse input on UI$3
- create_prefab - Create prefabs from GameObjects
- modify_prefab - Modify existing prefab properties
- instantiate_prefab - Instantiate prefabs in the scene
- create_material - Create new materials with shaders
- modify_material - Modify material properties and texturesRequirements
- Unity: 2020.3 LTS or newer
- Node.js: 18.0.0 or newer
- MCP Client: Claude Desktop, Cursor, or compatible client
Troubleshooting
$3
1. Ensure Unity Editor is running with the Unity package installed
2. Check Unity console for connection messages
3. Verify port 6402 is not blocked by firewall$3
`bash
Clear npm cache
npm cache clean --forceReinstall
npm uninstall -g unity-editor-mcp
npm install -g unity-editor-mcp
``Full source code and documentation: https://github.com/ozankasikci/unity-mcp
MIT License - see LICENSE file for details.