MCP Server for Unity
The Unity MCP Server enables AI-assisted development of Unity projects through programmatic interaction, offering comprehensive control over:
Project Management: Set up, validate, and manage Unity projects
Asset Creation & Management: Create and manage scripts, scenes, materials, shaders, and editor scripts
Material Handling: Create, update, clone materials, change shaders, and modify properties
Code Management: Create, update, analyze scripts, handle namespaces, and manage compilation
UI Toolkit Development: Create and manage UXML layouts, USS styles, and complete UI components
Editor Extensions: Build custom editor windows, property drawers, and scriptable object editors
Build Automation: Build for multiple platforms (Windows, macOS, Linux, iOS, Android, WebGL)
Diagnostics: Analyze logs, validate assets, run tests, and monitor compilation
Batch Operations: Execute efficient bulk operations on multiple assets
AI Integration: Analyze requirements, generate project structures, and implement game systems like player controllers, cameras, UI frameworks, and audio managers
Supports building Unity projects for Android as one of the available build targets.
Supports building Unity projects for iOS as one of the available build targets.
Supports building Unity projects for Linux (StandaloneLinux64) as one of the available build targets.
Supports building Unity projects for macOS (StandaloneOSX) as one of the available build targets.
Utilizes Node.js as the runtime environment for the MCP server, with Node.js 18.x or higher required.
Implements the MCP server using TypeScript for type-safe development and better code organization.
Enables direct interaction with Unity projects, providing tools for script creation, asset management, shader creation, custom editor extensions, ProBuilder integration, package management, and project building for multiple platforms.
Supports building Unity projects for WebGL as one of the available build targets.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Server for Unity create a PlayerController script with jump and movement"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Unity MCP Server
Unity MCP Server lets Claude work with your Unity projects! Create scripts, manage shaders, organize folders - all through natural conversation with Claude.
🎮 What Can You Do?
Talk to Claude to:
Create Unity Scripts: "Create a PlayerController script with jump functionality"
Manage Shaders: "Create a toon shader for my character"
Organize Projects: "Create a folder structure for my RPG game"
Get Project Info: "What render pipeline is my project using?"
Related MCP server: MCP Unity
🚀 Quick Start (Recommended: Claude Desktop Extension)
Option 1: Install via Claude Desktop Extension (Easiest)
Download the Extension
Go to Latest Release
Download
unity-mcp-server.dxt(42KB)
Install in Claude Desktop
Open Claude Desktop
Go to Extensions
Click "Install from file"
Select the downloaded
unity-mcp-server.dxt
Start Using!
Open any Unity project (2019.4 or newer)
Install Newtonsoft JSON package in Unity:
Open Window → Package Manager
Click the "+" button and select "Add package by name..."
Enter:
com.unity.nuget.newtonsoft-jsonClick "Add"
Ask Claude: "Setup Unity MCP in my project at /path/to/project"
Claude will install everything automatically!
Option 2: Manual Installation (For developers)
Clone and build:
git clone https://github.com/zabaglione/mcp-server-unity.git cd mcp-server-unity npm install npm run buildConfigure Claude Desktop:
{ "mcpServers": { "unity": { "command": "node", "args": ["/path/to/mcp-server-unity/build/simple-index.js"] } } }
📝 How to Use
Once installed, just talk to Claude naturally:
Creating Scripts
You: "Create a PlayerHealth script that handles damage and healing"
Claude: I'll create a PlayerHealth script for you...Creating Shaders
You: "I need a water shader with wave animation"
Claude: I'll create a water shader with wave animation...Organizing Your Project
You: "Set up a folder structure for a platformer game"
Claude: I'll create an organized folder structure for your platformer...Checking Project Info
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"
Make sure Unity Editor is open
Check Window → Unity MCP Server in Unity
Click "Start Server" if it's not running
"Can't find my project"
Tell Claude the exact path: "My Unity project is at C:/Projects/MyGame"
Make sure it's a valid Unity project with an Assets folder
Need Help?
Ask Claude: "Help me troubleshoot Unity MCP"
Check Issues
See Technical Documentation for advanced details
🎮 Unity Version Support
Unity 2019.4+ - Full support
Unity 6 (6000.0+) - Recommended for best experience
Works on Windows, macOS, and Linux
📈 Latest Updates (v3.1.1)
✅ Fixed render pipeline detection (now correctly identifies Built-in, URP, HDRP)
✅ Resolved AssetDatabase synchronization errors
✅ Improved file management and Unity integration stability
🤝 Contributing
Want to help improve Unity MCP Server? Check out our Contributing Guide!
📝 License
MIT License - see LICENSE
🙏 Acknowledgments
Anthropic for Claude and MCP
Unity Technologies for the amazing game engine
All our contributors and users!
Ready to supercharge your Unity development with Claude? Download the extension now!
Available Tools
15 toolsfolder_createC
Create a new folder in Unity project
Inputs: path (required).
folder_deleteC
Delete a folder from Unity project
Inputs: path (required), recursive.
folder_listB
List contents of a folder in Unity project
Inputs: path, recursive.
folder_moveC
Move a folder to a new location in Unity project
Inputs: sourcePath (required), targetPath (required).
folder_renameC
Rename a folder in Unity project
Inputs: oldPath (required), newName (required).
project_infoB
Get comprehensive Unity project information including render pipeline details, project path, Unity version, and platform info
Inputs: no named parameters.
project_statusA
Check Unity MCP server connection status (simple connectivity test only)
Inputs: no named parameters.
script_apply_diffC
Apply a unified diff to a C# script
Inputs: path (required), diff (required), options.
script_createC
Create a new C# script in Unity project
Inputs: fileName (required), content, folder.
script_deleteC
Delete a C# script from Unity project
Inputs: path (required).
script_readC
Read a C# script from Unity project
Inputs: path (required).
setup_unity_bridgeA
Install/update Unity MCP bridge scripts to a Unity project (works even if Unity server is not running)
Inputs: projectPath (required), forceUpdate.
shader_createC
Create a new shader in Unity project
Inputs: name (required), content, folder.
shader_deleteC
Delete a shader from Unity project
Inputs: path (required).
shader_readC
Read a shader from Unity project
Inputs: path (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 15 tools
Every tool has a clearly distinct purpose with no ambiguity. Tools are organized by resource type (folder, project, script, shader) and action (create, delete, list, move, rename, read, apply_diff, info, status, setup), making it easy for an agent to select the right tool. There is no overlap in functionality between tools.
Tool names follow a consistent verb_noun pattern throughout, with all names using snake_case. Examples include folder_create, script_read, shader_delete, and project_info. This predictability makes the tool set easy to navigate and understand.
With 15 tools, the count is well-scoped for a Unity MCP server, covering key operations for folders, projects, scripts, and shaders. Each tool earns its place by addressing specific needs in Unity project management, without being excessive or insufficient.
The tool set provides strong coverage for the Unity domain, including CRUD operations for folders, scripts, and shaders, along with project info and setup tools. Minor gaps exist, such as no update tools for scripts or shaders (only create, delete, read, and apply_diff for scripts), but agents can work around these with existing tools like script_apply_diff.
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables Claude to manage software development projects with complete context awareness and code execution through Docker environments.4-
- AlicenseNot gradedqualityDmaintenanceImplementation of the Model Context Protocol for Unity Editor, allowing AI assistants to interact with Unity projects through a Node.js server bridge.2MIT
- AlicenseNot gradedqualityBmaintenanceA Model Context Protocol server that integrates AI assistants like Claude and Cursor directly into the Unity Editor to automate game development workflows. It provides over 40 built-in tools for scene manipulation and project management, while offering a simple C# API for creating custom extensions.11GPL 3.0
- AlicenseNot gradedqualityCmaintenanceA Unity Editor MCP server that gives Claude Code full control over Unity projects through 268 tools, 7 resources, and specialized AI agents. It enables AI-assisted game development by allowing Claude to see, create, modify, and inspect everything in Unity including scenes, GameObjects, scripts, and builds.6MIT