home / mcp / unity mcp server

Unity MCP Server

Provides MCP-based control of Unity Editor tasks via HTTP and local stdio configurations.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "coplaydev-unity-mcp": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

You enable Unity editors to be guided by powerful language models through MCP for Unity. This server provides an HTTP endpoint for remote MCP clients and a local stdio option that lets your editor launch a built-in MCP flow, so you can control assets, scenes, scripts, and editor actions through natural language commands.

How to use

Connect your MCP client to the Unity MCP server to start using natural language to manage Unity tasks. The HTTP method provides a remote connection at http://localhost:8080/mcp, which you configure in your MCP client as your server URL. You may also run a local stdio configuration using uvx to communicate directly with the server from the editor. After connection, you can issue prompts like creating colored cubes, building simple player controllers, or automating repetitive Unity workflows. The server supports a range of tools for asset management, scene manipulation, script editing, material handling, and editor actions, making it easier to translate your ideas into Unity edits with LLM guidance.

How to install

Prerequisites you need before installing the server:

Unity 2021.3 LTS+ or newer
Python 3.10+ and uv
An MCP client such as Claude Desktop, Cursor, Windsurf, or VS Code Copilot
A Unity project to experiment with

Install the Unity package from the MCP for Unity repository using the package manager in Unity. You will add the package via a git URL or use alternative install methods if you prefer OpenUPM or the Asset Store.

To install via git URL in Unity:

Window > Package Manager > + > Add package from git URL...
https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main

Additional installation options

If you want the latest beta, switch to the beta branch in the git URL.

https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#beta

Alternative installation methods

OpenUPM and the Unity Asset Store offer additional install paths for MCP for Unity.

openupm add com.coplaydev.unity-mcp

Start the server and connect

1. In Unity, open the MCP panel: Window > MCP for Unity.

2. Click Start Server to launch the HTTP server on localhost:8080.

3. Select your MCP client from the dropdown and click Configure.

4. Look for a green Connected indicator.

5. Connect your client. Some clients may require enabling an MCP toggle in settings; others auto-connect after configuration.

After connection, try prompts like 'Create a red, blue and yellow cube' or 'Build a simple player controller' to start experimenting.

Security and privacy

The server supports anonymous telemetry with a privacy-focused approach. You can opt out by setting DISABLE_TELEMETRY=true in the environment.