Unity MCP Integration

Access real-time information about your Unity project Read/Write Functionality to Unity Project Files Understand your scene hierarchy and game objects Execute C# code directly in the Unity Editor Monitor logs and errors Control the Editor's play mode

Catalog onlyCatalog onlySTDIO

Overview

Unity MCP Integration is a tool that connects the Model Context Protocol (MCP) with the Unity Editor, allowing real-time interaction and information access for AI assistants within Unity projects.

To use Unity MCP Integration, install the Unity package via the Package Manager or import it as a custom package, then set up the MCP server to enable communication between the Unity Editor and the MCP protocol.

Access real-time information about Unity projects - Understand scene hierarchy and game objects - Execute C# code directly in the Unity Editor - Monitor logs and errors - Control the Editor's play mode

Enhancing AI assistants to interact with Unity projects.
Debugging and monitoring Unity projects in real-time.
Executing commands and retrieving information about game objects and scenes.

Add to your AI client

Use these steps to connect Unity MCP Integration in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "unitymcpintegration-shahzad": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-unitymcpintegration-shahzad"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "unitymcpintegration-shahzad": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-unitymcpintegration-shahzad"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "unitymcpintegration-shahzad": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-unitymcpintegration-shahzad"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "unitymcpintegration-shahzad": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-unitymcpintegration-shahzad"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "unitymcpintegration-shahzad": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-unitymcpintegration-shahzad"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "unitymcpintegration-shahzad": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-unitymcpintegration-shahzad"
      ]
    }
  }
}

Developer tools