SSyncDev

UnityMCPIntegration MCP Server

Integration between Model Context Protocol (MCP) and Unity, allowing AI assistants to understand and interact with Unity projects in real-time.

Local serverstdioTypeScript

What is the UnityMCPIntegration MCP Server?

Integration between Model Context Protocol (MCP) and Unity, allowing AI assistants to understand and interact with Unity projects in real-time. Provides access to

Configuration and credentials

  • Unity 2021.3 or later - Node.js 18+ (for running the MCP server)

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
get_editor_stateGet comprehensive information about the Unity project and editor state
get_current_scene_infoGet detailed information about the current scene
get_game_objects_infoGet information about specific GameObjects in the scene
execute_editor_commandExecute C code directly in the Unity Editor
get_logsRetrieve and filter Unity console logs
verify_connectionCheck if there's an active connection to Unity Editor
read_fileRead contents of a file in your Unity project
read_multiple_filesRead multiple files at once
write_fileCreate or overwrite a file with new content
edit_fileMake targeted edits to existing files with diff preview
list_directoryGet a listing of files and folders in a directory
directory_treeGet a hierarchical view of directories and files
search_filesFind files matching a search pattern
get_file_infoGet metadata about a specific file or directory
find_assets_by_typeFind all assets of a specific type (e.g. Material, Prefab)
list_scriptsGet a listing of all C scripts in the project

How to install the UnityMCPIntegration MCP Server

{
  "mcpServers": {
    "unity-mcp-server": {
      "command": "node",
      "args": [
        "path-to-project>\\Library\\PackageCache\\com.quaza.unitymcp@d2b8f1260bca\\mcpServer\\mcpServer\\build\\index.js"
      ],
      "env": {
        "MCP_WEBSOCKET_PORT": "5010"
      }
    }
  }
}

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

Configuration

  • Unity 2021.3 or later - Node.js 18+ (for running the MCP server)
VariableDescriptionRequired
MCP_WEBSOCKET_PORTDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use UnityMCPIntegration to get editor state.”
  • “Use UnityMCPIntegration to get current scene info.”
  • “Use UnityMCPIntegration to get game objects info.”

Frequently asked questions

Integration between Model Context Protocol (MCP) and Unity, allowing AI assistants to understand and interact with Unity projects in real-time. Provides access to Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.