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.
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?"
🚀 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-json
- Click "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:
- Configure Claude Desktop:
📝 How to Use
Once installed, just talk to Claude naturally:
Creating Scripts
Creating Shaders
Organizing Your Project
Checking Project Info
🎯 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!
local-only server
The server can only run on the client's local machine because it depends on local resources.
Tools
A Model Context Protocol server that enables Claude to interact directly with Unity projects, providing tools for script creation, asset management, and project building.
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol server that allows Claude to interact with Linear's API for managing teams, issues, projects, and cycles.Last updated -171TypeScriptMIT License
- -securityFlicense-qualityA Model Context Protocol server that allows Claude to make API requests on your behalf, providing tools for testing various APIs including HTTP requests and OpenAI integrations without sharing your API keys in the chat.Last updated -Python
- -securityAlicense-qualityA Model Context Protocol server that integrates Claude with Blender, enabling users to analyze and interact with IFC (Industry Foundation Classes) building models through natural language commands.Last updated -9PythonMIT License
- -securityFlicense-qualityA server implementation of the Model Context Protocol that allows users to extend Claude's capabilities by creating custom tools that can be used within the Claude Desktop client.Last updated -TypeScript