Unity MCP Server

How to use

Interact with Claude in natural language to perform common Unity tasks. You can ask Claude to create scripts that follow Unity conventions, generate shaders for your render pipeline, establish a practical folder structure for your project, or check basic project information such as the render pipeline and Unity version. For example, you might say: Create a PlayerHealth script that handles damage and healing, or set up a water shader with wave animation. Claude will respond with actions that implement the requested functionality while handling Unity assets safely.

How to install

Prerequisites: you need Node.js and npm installed on your system. Ensure you have a modern Unity editor (2019.4 or newer) and that you can access the Unity project folder where you want to enable MCP integration.

Manual installation steps

git clone https://github.com/zabaglione/mcp-server-unity.git
cd mcp-server-unity
npm install
npm run build

After building, configure Claude Desktop to run the Unity MCP server locally. Add the following configuration snippet to your Claude Desktop MCP settings to point to the built server.

{
  "mcpServers": {
    "unity": {
      "command": "node",
      "args": ["/path/to/mcp-server-unity/build/simple-index.js"]
    }
  }
}

Option 1: Claude Desktop Extension (easiest)

If you prefer a quick setup, install the Claude Desktop Extension and enable the Unity MCP Server from there. This option streamlines the process and wires Claude directly to Unity projects.

Option 2: Use the built-in flow (developers)

If you are integrating in a custom workflow, you can run the server locally using Node. The built server is invoked from the built script as shown in the manual steps above.

Using the MCP in your workflow

Once installed, you can begin interacting with Claude to perform Unity-related tasks. For example, you can request script creation, shader generation, or project organization, and Claude will guide you through the changes, ensuring safe asset handling and proper Unity integration.

Additional steps for setup (Notes)

Install the Newtonsoft JSON package in Unity if you plan to exchange data with Claude via JSON. In Unity: Window → Package Manager → Add package by name… and enter com.unity.nuget.newtonsoft-json, then Add.

Troubleshooting

If you encounter issues, verify that the Unity Editor is open and that the MCP server is registered in Unity under Window → Unity MCP Server. If the server is not running, start it from that panel.

Unity version and platform support

Supports Unity 2019.4 and newer. Works on Windows, macOS, and Linux.

Latest updates (v3.1.1)

Includes improved render pipeline detection for Built-in, URP, and HDRP, resolved AssetDatabase synchronization issues, and enhancements to file management and Unity integration stability.

Contributing

Contribute to the Unity MCP Server by following the contribution guidelines and contributing to the codebase.

License

MIT License - see LICENSE

Acknowledgments

Thanks to Claude, Unity Technologies, and the community for their support and feedback.

Ready to supercharge your Unity development with Claude

If you want to enable Claude to work with your Unity projects right away, install the Unity MCP Server and start creating scripts, shaders, and organized project structures with natural language.

scriptCreation

Creates Unity MonoBehaviour scripts following common patterns and conventions so you can implement features quickly.

shaderManagement

Generates and updates shaders compatible with Built-in, URP, and HDRP pipelines.

projectOrganization

Creates, moves, and renames folders to keep Unity projects tidy and easy to navigate.

projectInfoCheck

Provides quick information about the Unity project, such as render pipeline and Unity version.

unitySetup

Automatically sets up the Unity integration within a project for seamless Claude usage.