home / mcp / unity mcp server

Unity MCP Server

MCP server that connects Claude to Unity projects to list, inspect, and access project structures.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "artmann-unity-mcp": {
      "command": "npx",
      "args": [
        "unity-mcp@latest"
      ]
    }
  }
}

This Unity MCP Server lets Claude connect to your Unity projects. It exposes commands to list projects, fetch detailed project information, and explore project structure and files, empowering you to integrate Unity content into Claude-driven workflows efficiently.

How to use

You use this MCP server from your Claude client by selecting or adding the server configuration described below. Once configured, you can browse your Unity projects, request detailed project data, and inspect project structures and files through Claude’s MCP interface. Use the standard MCP workflow to start the server, then query for the list of Unity projects or specific project details as needed. If you have multiple Unity projects, you can inspect each one to understand its layout and assets before taking action in Claude.

How to install

Prerequisites you need before installing the server: Bun runtime. You can run the MCP server directly with npx without installing it locally, or you can run it from a local clone of the project.

# Option 1: Run with NPX (recommended for quick start)
npx unity-mcp@latest

Add this MCP server to Claude using one of the provided configuration options. The following JSON snippet shows how to configure the NPX-based server entry.

{
  "mcpServers": {
    "unity_npx": {
      "command": "npx",
      "args": ["unity-mcp@latest"]
    }
  }
}

Option 2 runs the server from a local clone of the project. Install the project dependencies, then configure Claude to start the local runtime. The command shown runs the local script via Bun.

# Option 2: Run this project locally
git clone https://github.com/your-username/unity-mcp.git
cd unity-mcp
bun install
```

```json
{
  "mcpServers": {
    "unity_localbun": {
      "command": "bun",
      "args": ["run", "C:\\Users\\Artga\\Code\\unity-mcp\\src\\index.ts"]
    }
  }
}

Notes on usage and troubleshooting when installing: ensure Unity is installed and you have at least one configured Unity project. The MCP server will emit logs to standard error; on macOS, Claude’s app logs can be found under ~/Library/Logs/Claude, and logs for other platforms are located in their corresponding log directories.

Additional content

Security and troubleshooting details: if you encounter issues, verify that the server can access the Unity projects data file (projects-v1.json) and that you have appropriate permissions for Unity project directories. If you cannot get the MCP server working, open an issue with details about your environment and the steps you took.

Development and debugging notes: MCP servers run over stdio, so debugging can be challenging. For the best experience, use the MCP Inspector. You can start the Inspector with the following command to launch a debugging URL in your browser.

bun run inspector

Available tools

list_projects

Lists all Unity projects accessible to the MCP server, allowing you to see available namespaces and project names.

get_project_info

Retrieves detailed information for a specific Unity project, including metadata and key attributes.

get_project_structure

Provides access to the project structure and files so you can inspect folders, assets, and organization within a project.