Unity MCP
by justinpbarnett
Unity MCP connects your Unity Editor to LLMs using the Model Context Protocol. It acts as a bridge, allowing AI assistants to interact directly with your Unity Editor via a local MCP Client.
Last updated: N/A
What is Unity MCP?
Unity MCP is a bridge that allows AI assistants (like Claude, Cursor) to interact directly with your Unity Editor via a local MCP (Model Context Protocol) Client. It consists of a Unity package (Unity MCP Bridge) and a Python server (Unity MCP Server) that facilitates communication between the LLM and the Unity Editor.
How to use Unity MCP?
To use Unity MCP, you need to install the Unity package via the Package Manager, install the Python server manually, and configure your MCP Client (Claude, Cursor, etc.) to connect to the server. After installation and configuration, you can interact with your Unity project using natural language commands through your MCP Client.
Key features of Unity MCP
Natural Language Control
Powerful Tools for asset, scene, material, and script management
Automation of repetitive Unity workflows
Extensible design to work with various MCP Clients
Use cases of Unity MCP
Automating asset creation and modification
Controlling scene elements and hierarchy
Editing and managing C# scripts
Executing Unity editor functions via natural language
FAQ from Unity MCP
Unity Bridge Not Running/Connecting?
Unity Bridge Not Running/Connecting?
Ensure Unity Editor is open, check the status window (Window > Unity MCP), and restart Unity.
MCP Client Not Connecting / Server Not Starting?
MCP Client Not Connecting / Server Not Starting?
Verify the server path in your MCP Client's JSON config, ensure uv is installed and working, and try running the server directly from the terminal to see errors.
Auto-Configure Failed?
Auto-Configure Failed?
Use the Manual Configuration steps. Auto-configure might lack permissions to write to the MCP client's config file.
What functions are available to the LLM?
What functions are available to the LLM?
The LLM can use functions like read_console, manage_script, manage_editor, manage_scene, manage_asset, manage_gameobject, and execute_menu_item.
What are the prerequisites for using Unity MCP?
What are the prerequisites for using Unity MCP?
You need Git CLI, Python (3.12+), Unity Hub & Editor (2020.3 LTS+), uv (Python package manager), and an MCP Client (Claude, Cursor, etc.).