Unity MCP server

Unity MCP Server is a tool that allows Claude to interact with your Unity projects through natural conversation. You can create scripts, manage shaders, organize folders, and get project information by simply talking to Claude, making Unity development more intuitive and efficient.

Getting Started

Installation via Claude Desktop Extension (Recommended)

1. Download the extension file:

   • Visit Latest Release
   • Download the unity-mcp-server.dxt file (42KB)

2. Install in Claude Desktop:

   • Open Claude Desktop
   • Navigate to Extensions
   • Click "Install from file"
   • Select the downloaded unity-mcp-server.dxt

3. Set up your Unity project:

   • Open any Unity project (2019.4 or newer)
   • Install the required Newtonsoft JSON package:

     Window → Package Manager → "+" button → "Add package by name..." → 
     Enter: com.unity.nuget.newtonsoft-json → Click "Add"
     

   • Ask Claude: "Setup Unity MCP in my project at /path/to/project"
   • Claude will automatically complete the installation process

How to Use

Once installed, you can interact with Claude using natural language to manage your Unity project:

Creating Scripts

Simply describe the script you need:

You: "Create a PlayerHealth script that handles damage and healing"
Claude: I'll create a PlayerHealth script for you...

Creating Shaders

Ask for specific shader functionality:

You: "I need a water shader with wave animation"
Claude: I'll create a water shader with wave animation...

Organizing Your Project

Request help with project organization:

You: "Set up a folder structure for a platformer game"
Claude: I'll create an organized folder structure for your platformer...

Checking Project Information

Get details about your Unity project:

You: "What Unity version and render pipeline am I using?"
Claude: Let me check your project information...

Features

• Smart Script Creation - Claude understands Unity patterns and creates proper MonoBehaviours
• Shader Support - Works with Built-in, URP, and HDRP render pipelines
• Project Organization - Create, move, and rename folders to keep projects tidy
• Auto Setup - Claude automatically sets up the Unity integration when needed
• Safe Operations - All changes are made safely with proper Unity asset handling

Troubleshooting

"Unity server not responding"

1. Ensure the Unity Editor is open
2. Check Window → Unity MCP Server in Unity
3. Click "Start Server" if it's not running

"Can't find my project"

• Provide Claude with the exact path: "My Unity project is at C:/Projects/MyGame"
• Confirm it's a valid Unity project with an Assets folder

Unity Version Support

• Unity 2019.4 and newer versions are fully supported
• Unity 6 (6000.0+) is recommended for the best experience
• Compatible with Windows, macOS, and Linux

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "unity-bridge" '{"command":"unity-mcp-bridge","args":[]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "unity-bridge": {
            "command": "unity-mcp-bridge",
            "args": []
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "unity-bridge": {
            "command": "unity-mcp-bridge",
            "args": []
        }
    }
}

3. Restart Claude Desktop for the changes to take effect