# unity-mcp-server

Bridges AI coding assistants to Unity Editor and Unity Hub over MCP for direct control of scenes, GameObjects, and components.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 128 installs · ★ 9 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/unity-mcp-server/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/unity-mcp-server

## What it does

This skill connects your coding assistant to Unity Editor and the Unity Hub CLI. The system splits 288 tools into two tiers: roughly 70 core tools surface immediately, while over 130 specialized operations load on demand through the `unity_advanced_tool` proxy to keep client contexts responsive.

Communication flows from the assistant into a Node.js MCP server, which talks to an HTTP bridge running inside Unity on port 7890. You can paginate through scene hierarchies, spawn primitive objects, update local or world transforms, inspect and tweak component properties, and batch-wire dependencies across scripts.

Without `unity-mcp-plugin` installed and running inside the active Unity Editor project, the HTTP bridge cannot receive commands.

## Requirements
- Works with: Unity

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill unity-mcp-server -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/unity-mcp-server/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/unity-mcp-server/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill unity-mcp-server -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/unity-mcp-server/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill unity-mcp-server -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/unity-mcp-server/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/mcp-skills skills/unity-mcp-server
```

2. **Manually: put the files in place**
- File: `.github/skills/unity-mcp-server/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill unity-mcp-server -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/unity-mcp-server
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/unity-mcp-server/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill unity-mcp-server -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/unity-mcp-server/SKILL.md

## When to use it
- fetch Unity scene hierarchies with paginated outputs
- spawn primitive GameObjects and update local transforms
- attach components and edit field values programmatically
- batch-wire references between components across scene objects
- manage installed editor builds and modules using Unity Hub CLI

## Example prompts
- List the first 50 GameObjects in the current scene hierarchy
- Spawn a primitive Cube named RedCube at 0, 2, 0 and attach a Rigidbody
- Set the mass property on the Rigidbody component of RedCube to 10.5

## Similar
- [unity-animation](https://affpapa.org/en/nevibecode/skills/unity-animation.md) — skill · 11400 installs
- [unity-scriptableobjects](https://affpapa.org/en/nevibecode/skills/unity-scriptableobjects.md) — skill · 11300 installs
- [unity-pipeline](https://affpapa.org/en/nevibecode/skills/unity-pipeline.md) — skill · 2700 installs
- [unity-package-management](https://affpapa.org/en/nevibecode/skills/unity-package-management.md) — skill · 9000 installs
- [unity-mcp-orchestrator](https://affpapa.org/en/nevibecode/skills/unity-mcp-orchestrator.md) — skill · ★ 16105 repo stars
- [unity](https://affpapa.org/en/nevibecode/skills/unity.md) — skill · 967 installs

From the same set: [reason-machines/mcp-skills](https://affpapa.org/en/nevibecode/by/reason-machines/mcp-skills.md) — 98 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
