Skip to main content
Glama

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.

日本語版 README はこちら | English

🎮 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

Option 1: Install via Claude Desktop Extension (Easiest)

  1. Download the Extension

  2. Install in Claude Desktop

    • Open Claude Desktop

    • Go to Extensions

    • Click "Install from file"

    • Select the downloaded unity-mcp-server.dxt

  3. 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)

  1. Clone and build:

    git clone https://github.com/zabaglione/mcp-server-unity.git
    cd mcp-server-unity
    npm install
    npm run build
  2. Configure 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"

  1. Make sure Unity Editor is open

  2. Check Window → Unity MCP Server in Unity

  3. 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?

🎮 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


Ready to supercharge your Unity development with Claude? Download the extension now!

Available Tools

15 tools
folder_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

    A3.5/5.0

    Scored across 15 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Implementation of the Model Context Protocol for Unity Editor, allowing AI assistants to interact with Unity projects through a Node.js server bridge.
      2
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      A 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.
      11
      GPL 3.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      A 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.
      6
      MIT