unity-mcp-server — Claude Code skill: what it does, how to install
Bridges AI coding assistants to Unity Editor and Unity Hub over MCP for direct control of scenes, GameObjects, and components.
no license 128 installs ★ 9 updated 2026-10-09
npx skills add reason-machines/mcp-skills --skill unity-mcp-server -a claude-codeWhat unity-mcp-server 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.
What it helps with
- 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 for the agent
- 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
How to install unity-mcp-server
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill unity-mcp-server -a claude-code2Manually: put the files in place
~/.claude/skills/unity-mcp-server/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/unity-mcp-server/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill unity-mcp-server -a codex2Manually: put the files in place
.agents/skills/unity-mcp-server/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill unity-mcp-server -a cursor2Manually: put the files in place
.cursor/skills/unity-mcp-server/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/mcp-skills skills/unity-mcp-server2Manually: put the files in place
.github/skills/unity-mcp-server/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill unity-mcp-server -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/unity-mcp-serverManually: put the files in place
.devin/skills/unity-mcp-server/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill unity-mcp-server -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about unity-mcp-server
How to install unity-mcp-server in Claude Code?
Run npx skills add reason-machines/mcp-skills --skill unity-mcp-server -a claude-code in your terminal.
What does unity-mcp-server do?
It gives your assistant 288 tools to inspect and alter Unity scenes, components, assets, and editor installations.
What dependencies are needed inside the Unity project?
You must install https://github.com/AnkleBreaker-Studio/unity-mcp-plugin.git via the Package Manager so the local HTTP bridge can listen on port 7890.