Unity-MCP unity-initial-setup

install

source · Clone the upstream repo

git clone https://github.com/IvanMurzak/Unity-MCP

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/IvanMurzak/Unity-MCP "$T" && mkdir -p ~/.claude/skills && cp -r "$T/Unity-MCP-Plugin/.claude/skills/unity-initial-setup" ~/.claude/skills/ivanmurzak-unity-mcp-unity-initial-setup && rm -rf "$T"

manifest: Unity-MCP-Plugin/.claude/skills/unity-initial-setup/SKILL.md

source content

AI Game Developer — Initial Setup

This guide walks through installing the

unity-mcp-cli

command-line tool and using it to set up a Unity project with AI Skills and MCP integration.

Prerequisites

Install Node.js

unity-mcp-cli

requires Node.js ^20.19.0 || >=22.12.0 (Node 21.x is not supported). If you don't have Node.js installed:

Download the installer from https://nodejs.org/ and run it, or use a package manager:

winget install OpenJS.NodeJS.LTS

After installation, verify both

node

and

npm

are available:

node --version
npm --version

Install

unity-mcp-cli

Globally

Install the CLI globally so the

unity-mcp-cli

command is available system-wide:

npm install -g unity-mcp-cli

Verify installation:

unity-mcp-cli --version

Alternative: Run any command without installing globally using
npx
:
npx unity-mcp-cli --help

Quick Start — Full Project Setup

1. Install the Unity-MCP Plugin

Add the plugin to an existing Unity project:

unity-mcp-cli install-plugin /path/to/unity/project

2. Configure MCP Tools

Enable all tools, prompts, and resources:

unity-mcp-cli configure /path/to/unity/project \
  --enable-all-tools \
  --enable-all-prompts \
  --enable-all-resources

3. Set Up MCP for Your AI Agent

Configure MCP integration for your AI agent (e.g., Claude Code, Cursor, Copilot):

unity-mcp-cli setup-mcp claude-code /path/to/unity/project

List all supported agents:

unity-mcp-cli setup-mcp --list

4. Generate AI Skills

Generate skill files for your AI agent (requires Unity Editor to be running with the plugin):

unity-mcp-cli setup-skills claude-code /path/to/unity/project

5. Open Unity with MCP Connection

unity-mcp-cli open /path/to/unity/project

Common Commands Reference

Command	Description
`unity-mcp-cli install-plugin <path>`	Install Unity-MCP plugin into a project
`unity-mcp-cli remove-plugin <path>`	Remove Unity-MCP plugin from a project
`unity-mcp-cli configure <path> --list`	List current MCP configuration
`unity-mcp-cli setup-mcp <agent> <path>`	Write MCP config for an AI agent
`unity-mcp-cli setup-skills <agent> <path>`	Generate skill files for an AI agent
`unity-mcp-cli create-project <path>`	Create a new Unity project
`unity-mcp-cli install-unity <version>`	Install a Unity Editor version
`unity-mcp-cli open <path>`	Open a Unity project in the Editor
`unity-mcp-cli run-tool <tool> <path>`	Execute an MCP tool via HTTP API

Add

--verbose

to any command for detailed diagnostic output.

Troubleshooting

npm
not found: Node.js is not installed or not in your PATH. Reinstall Node.js and restart your terminal.
Plugin not appearing in Unity: After
```
install-plugin
```
, open the project in Unity Editor. The package manager resolves dependencies on project open.
Skills generation fails: Ensure Unity Editor is running with the MCP plugin installed and connected before running
```
setup-skills
```
.