Home › Unity MCP Setup: Connect Claude Code, Cursor or Codex to the Unity Editor (2026)

Unity MCP Setup: Connect Claude Code, Cursor or Codex to the Unity Editor (2026)

If you set up Unity MCP from a tutorial written earlier this year, it's probably out of date. Unity has deprecated the MCP server inside its AI Assistant package and moved MCP into the free Unity CLI, which talks to a running Editor through the Unity Pipeline package. This guide shows the current setup for Claude Code, Cursor and Codex from Unity's own docs (MCP checked November 1, 2026; Codex plugin re-checked November 5, 2026; CLI skill sync / beta.16–beta.17 release notes read November 5, 2026), what the server did when we ran it ourselves, when you're better off with Unity's official agent plugin (skills for Codex, Claude Code and more) or a community server, and how `unity skill sync` keeps those skills current.

Last updated:

Free download · one page + PDF · updated weekly, current edition November 16, 2026

🎁 Free: The AI Game Dev Stack 2026

The best AI tool for each job in a solo or indie game (3D, sprites and pixel art, animation, audio, NPCs), MCP setups for Unity, Unreal, Godot and Roblox, and which free plans you can actually ship with.

Yours free when you join the VibeStack Weekly: new AI game-dev tools and releases every Monday, 5-minute read. Unsubscribe anytime.

The short answer

Only want help writing C#? You don't need MCP for that: open the project folder in Cursor or run Claude Code or OpenAI Codex in it, as in our AI tools for Unity guide. MCP is for the next step, letting the agent work in the running Editor: run tests, inspect the scene, change settings and check its own work.

What changed: the in-Editor MCP server is deprecated

Unity's AI Assistant package (com.unity.ai.assistant) shipped an MCP server that ran inside the Editor, and many early-2026 guides point at it. Its docs page now says: “Unity MCP server is deprecated. Use the Unity command-line interface (CLI) instead.” The replacement is the unity mcp command. It uses the same protocol, so your client connects the same way, but it's built into the unity binary and reaches the Editor through the Unity Pipeline package (com.unity.pipeline), which runs a local server in the Editor that only accepts connections from localhost.

Your setupAffected by the deprecation?
AI Assistant package with its MCP server turned onYes. Migrate to unity mcp
A community MCP package installed from GitHubNo
unity mcp or unity command from the Unity CLINo. This is the supported path

If your project also uses the AI Assistant package, Unity says versions 2.13 and later fix a conflict between it and the CLI, so update it.

What you need

The CLI is labelled experimental in Unity's docs. The current beta channel releases are 1.0.0-beta.16 (November 3, 2026) and 1.0.0-beta.17 (November 5, 2026); our own MCP dry-run used 1.0.0-beta.15 (October 29, 2026). Expect changes before 1.0.

Set up the Unity CLI and Pipeline package

  1. Install the CLI. macOS or Linux:
    curl -fsSL https://unity.com/install.sh | bash
    Windows (PowerShell):
    irm https://unity.com/install.ps1 | iex
    Check it with unity --version. On Linux it goes to ~/.local/bin/unity. On our Linux test machine on November 1, the plain install command failed with “Failed to fetch version manifest”, because the stable channel's latest.json returned 404. Setting the beta channel worked:
    curl -fsSL https://unity.com/install.sh | UNITY_CLI_CHANNEL=beta bash
    The install script also offers to set up your coding agents; set UNITY_CLI_SKIP_SETUP=1 to skip that.
  2. Open your project in the Unity Editor, then sign in from a terminal: unity auth login.
  3. Add the Pipeline package: run unity pipeline install from the project folder, wait for the Editor to recompile, then check with unity pipeline list (look for “Pipeline: Installed”).
  4. Confirm the CLI can reach the Editor: unity status should list a ready Editor with its port, project path, version and process ID.

Connect Claude Code, Cursor or Codex

The CLI writes the client config for you. Run unity mcp configure --list to see every supported client and where its config lives (our run listed 17, including Claude Desktop, Claude Code, Cursor, VS Code, Copilot CLI, Windsurf, Cline, Codex, Kiro, Antigravity and Zed). Add --dry-run to see the entry before it's written.

Claude Code. Run:

unity mcp configure claude-code

In our dry run this called Claude Code's own command, registering the server at user scope (once per machine, not per project):

claude mcp add --scope user --transport stdio unity-editor-mcp unity mcp

Check it with claude mcp list or /mcp inside Claude Code. If you have several Unity projects open, pin one with --project-path.

Cursor. unity mcp configure cursor writes ~/.cursor/mcp.json; add --local for the project's own .cursor/mcp.json. The entry it wrote in our dry run (with the full path to your unity binary):

{
  "mcpServers": {
    "unity": {
      "command": "/home/you/.local/bin/unity",
      "args": ["mcp"]
    }
  }
}

Codex. unity mcp configure codex adds this to ~/.codex/config.toml:

[mcp_servers.unity]
command = "/home/you/.local/bin/unity"
args = ["mcp"]

It also relaxes Codex's sandbox network policy so the CLI can reach the Editor over localhost, which is why editing the file by hand without that change may leave Codex unable to connect. According to the CLI skill in Unity's agent plugin, the CLI refuses to edit a config.toml it can't safely parse rather than risk corrupting it.

MCP, direct commands or Unity's agent plugin?

RouteHow it worksBest for
unity mcpMCP server; tools come from the connected EditorClients that can't run shell commands, or models that don't build command lines reliably (Unity's own reasoning)
unity command / unity evalThe agent runs CLI commands directly against the EditorAgents with a terminal. Unity says it's faster and uses fewer tokens than MCP
Unity's agent pluginSkills only, no MCP server; the skills run Unity CLI commandsClaude Code, Codex or Grok users who want Unity-specific know-how (Unity lists these three)

The plugin lives at Unity-Technologies/unity-agent-plugin. Unity's Codex blog (September 16, 2026) listed 31 skills at launch; the repo had 33 skill directories when we checked on November 1 and again on November 5, 2026. Coverage includes URP post-processing, migrating from Built-in to URP, UI Toolkit/uGUI/IMGUI, sprite atlases, 2D pixel-perfect, AI navigation, localization, multiplayer services, web optimization, IAP/LevelPlay and the unity-cli skill itself. It is published by Unity Technologies under the Unity Companion License.

Claude Code

In Claude Code:

/plugin marketplace add Unity-Technologies/unity-agent-plugin
/plugin install unity@unity-agent-plugin

or run unity setup claude. Type /unity: to see the skills. Unity's own notes on the plugin are candid: for simple uGUI work it makes little difference, and on Sonnet 5 it mainly supplies correctness, because the model already builds most features but defaults to older approaches. You can use the plugin and MCP together; unity mcp configure claude-code warns you if a plugin already registers the same server.

OpenAI Codex (official plugin)

Unity's official Codex plugin uses the same marketplace. Per Unity's Codex plugin docs and Unity blog post (September 16, 2026; Unity for Games also highlighted it again in early November 2026):

codex plugin marketplace add Unity-Technologies/unity-agent-plugin
codex plugin add unity@unity-agent-plugin

We haven't installed the Codex plugin hands-on yet; the commands and skill counts above are from Unity's docs, blog and the public GitHub repo. The same plugin family also has install pages for Grok and Google Antigravity under Unity's “plugin for third-party agents” docs.

What we tested

We installed Unity CLI 1.0.0-beta.15 on a Linux machine with no Unity Editor and talked to unity mcp over raw MCP (JSON-RPC on stdio) on November 1, 2026:

New in Unity CLI 1.0.0-beta.15 (October 29, 2026)

Keep Unity skills current: unity skill sync (beta.16+)

Unity skills (the packages Unity ships for Claude Code, Codex, Grok and other agents) are separate from MCP. MCP exposes live Editor tools; skills teach the agent how Unity jobs are meant to be done and often call the CLI. From 1.0.0-beta.16 (November 3, 2026), the CLI can install or refresh those skills without a prompt:

Related Editor/CLI improvements in the same beta.16 notes (also useful for agents): unity command editor dialog / unity command editor dialog answer <id> <button> (needs an Editor version that supports it); unity build --target can build through an already-open Editor; and object-level VCS helpers such as unity vcs summarize --objects and unity vcs guid.

Also in 1.0.0-beta.17 (November 5, 2026)

We have not installed beta.16 or beta.17 on this box, and we have not run unity skill sync, VS Code/OpenCode setup, dialog commands, open-Editor builds or object-level VCS ourselves. Commands and behaviour above are from Unity's CLI release notes only.

Community Unity MCP servers

Before Unity's CLI, most people used community packages, and Unity says those aren't affected by the deprecation. The three biggest on GitHub, all actively updated in late October 2026:

ProjectLicenseGitHub stars (Nov 1)
CoplayDev/unity-mcpMITabout 15,600
IvanMurzak/Unity-MCPApache-2.0about 4,600
CoderGamester/mcp-unityMITabout 2,000

We didn't test these. They make sense if you're on an Editor older than Unity 6 (the Pipeline package needs 6.0+) or you rely on a tool they have that Unity's server doesn't. For a new Unity 6 project, Unity's own CLI is the safer default: it's first-party, free, and it's where Unity is putting its agent work.

New: IvanMurzak/Unity-MCP can import Asset Store packs you own (1.11.0, November 11, 2026)

Unity-MCP 1.11.0 (the plugin behind AI Game Developer) adds two Asset Store tools. assetstore-library searches the packs in your Unity account's My Assets (and the local Asset Store cache) and shows which are downloaded or already in the project; assetstore-add takes a product ID, imports the pack and returns the prefab, material and model paths it added. Per a MakeGameWithAI write-up of the developer's demo, you need to be signed in to your Unity account in the Editor, the result can warn about a render-pipeline mismatch (a URP pack in a Built-in project, for example), and Unity 6.6 may pause the import at a package-signature prompt that you have to answer yourself. It only imports packs you already own; it doesn't buy anything.

How to use it safely: commit first, ask the agent to list what it imported before it places anything in a scene, and check the render pipeline. If you import packages with Unity's own CLI instead, add --require-signed (see Safety below). The same release train (Unreal-MCP 0.31.0) gives Unreal a matching Fab family: fab-search, fab-library and fab-add. We haven't run either. Sources: the two GitHub release pages (read November 14, 2026) and the write-up above.

Safety: what the agent can touch

Troubleshooting

SymptomLikely causeFix
The agent only sees unity-cli-statusNo Editor reachableOpen the project, run unity pipeline install, then unity status
Install script: “Failed to fetch version manifest”No stable release yet (our Nov 1 test)Add UNITY_CLI_CHANNEL=beta
Two Editors open, wrong projectThe CLI picked the other onePin it: unity mcp --project-path /path/to/project or configure ... --project-path
Codex can't reach the EditorSandbox blocks localhostUse unity mcp configure codex so it updates the network policy
Claude Code: “already exists in user config”It's registered at user scope alreadyNothing to do; one entry serves every project
Conflicts with the AI Assistant packageAssistant older than 2.13Update the AI Assistant package

What we didn't test

Other engines: the same idea for Godot is in our Godot MCP setup guide (community servers), for Unreal Engine 5.8 and UEFN in Unreal MCP and UEFN MCP setup, and for Roblox in Roblox Studio MCP setup. All four side by side: game engine MCP servers compared.

Related: AI tools for Unity · text-to-3D for Unity and Godot · AI playtesting and QA · Claude Code vs Codex.

Building with agents? Get the VibeStack Weekly digest: new AI game-dev tools and workflows, every Monday.

Sources (MCP and Claude plugin checked November 1, 2026; Codex plugin re-checked November 5, 2026; CLI skill sync / beta.16–beta.17 release notes read November 5, 2026): Unity's docs Unity CLI as the replacement for the in-Editor MCP server, Use the Unity CLI, the Unity CLI reference, Unity Pipeline package and Unity's plugin for Claude Code, Unity's plugin for Codex, Unity's plugin for third-party agents and Unity's blog The Official Unity Plugin for Codex (September 16, 2026); the deprecation note on the AI Assistant package's MCP server page; Unity's Unity CLI release notes (1.0.0-beta.16 November 3, 2026; 1.0.0-beta.17 November 5, 2026); Unity's Unity CLI 1.0.0-beta.16 Discussions post (rediscovery only; November 2026) and Unity CLI 1.0.0-beta.15 Discussions post (October 29, 2026); the Unity-Technologies/unity-agent-plugin repository (33 skill directories on November 5, 2026); the GitHub pages of CoplayDev/unity-mcp, CoderGamester/mcp-unity and IvanMurzak/Unity-MCP; and the MCP docs for Claude Code, Cursor and Codex. The MCP test results are from our own run of Unity CLI 1.0.0-beta.15 on a Linux machine without a Unity Editor (November 1, 2026). We have not installed beta.16 or beta.17 on the box, and we have not run skill sync, VS Code/OpenCode setup, Editor dialog commands, open-Editor builds or object-level VCS diffs ourselves. VibeStack Weekly isn't affiliated with Unity, Anthropic, Anysphere, OpenAI or the community projects, and none of them pays us.

Get the Starter Stack ($12) Get the free weekly digest

Our picks (5)

free

Unity CLI

Game Dev Tools

Unity's free command-line tool (1.0.0 beta) for coding agents: `unity mcp` is Unity's supported MCP server for Claude Code, Cursor or Codex (Unity 6.0+ with the Pipeline package). Beta.16+ adds `unity skill sync` to install/update one agent's Unity skills without prompting (plus `unity setup vscode` / `opencode`, Antigravity/Qwen skill install, and Editor dialog commands); beta.15 added Project Auditor and an offline docs cache.

#unity#mcp#cli

Unity AI

Game Dev Tools

Unity's in-editor AI assistant and generators (credit-based; included in Pro and up, trial for Personal). Its MCP server for coding agents now lives in the free Unity CLI (the AI Assistant package's MCP server is deprecated).

#engine

Claude Code

AI Code Editors & Agents

Anthropic's agentic coding tool for the terminal, VS Code and JetBrains. Uses a Claude Pro/Max plan or the API.

#cli#agent
freemium

Cursor

AI Code Editors & Agents

AI-first code editor with agent mode, built on VS Code.

#editor#agent
freemium

OpenAI Codex

AI Code Editors & Agents

OpenAI's coding agent: CLI, IDE extension, web and cloud tasks. Included in ChatGPT plans (Free with limits). Unity ships an official Codex skills plugin (unity@unity-agent-plugin) for Unity 6+. The ModRetro Chromatic plugin (November 2026) builds Game Boy and Game Boy Color games as GB Studio projects, playtests them in a built-in emulator and can flash them to a Chromatic handheld cartridge.

#cli#agent

+ Your tool here

Reach builders, vibe coders & indie game devs. Featured listings from $49/mo.

Advertise →
🧰 The Vibe Coder's Starter Stack: AI rules files, a prompt library and a ship-it checklist. $12.
Get the pack

FAQ

Does Unity have an official MCP server?

Yes. It's part of the free Unity CLI: run unity mcp, or let unity mcp configure add it to your client. It reaches a running Unity 6 Editor through the Unity Pipeline package. The older MCP server inside the AI Assistant package (com.unity.ai.assistant) is deprecated.

How do I connect Claude Code to Unity?

Install the Unity CLI, open your project in Unity 6 or later, run unity auth login and unity pipeline install, then run unity mcp configure claude-code. It registers a user-scope stdio server named unity-editor-mcp. Check it with claude mcp list. Unity's Claude Code plugin (unity@unity-agent-plugin) adds Unity skills on top.

How do I connect Cursor or Codex to Unity?

Run unity mcp configure cursor (add --local for the project's .cursor/mcp.json) or unity mcp configure codex. Both write an entry whose command is the unity binary with the argument mcp. For Codex it also lets the sandbox reach the Editor on localhost.

Does Unity have an official Codex plugin?

Yes. Install with codex plugin marketplace add Unity-Technologies/unity-agent-plugin, then codex plugin add unity@unity-agent-plugin (Unity 6+). Verify with /unity: or codex plugin list. It is a skills package from the same unity-agent-plugin repo as the Claude Code plugin, not an MCP server; use it alongside unity mcp configure codex when you want a live Editor.

Do I need a Unity AI subscription for Unity MCP?

No. Unity says the CLI is free and separate from Unity AI, and installing it doesn't need a Unity AI subscription. It works with the agent you already use.

Why does my agent only see one Unity tool?

Because no Editor is connected. In our test, unity mcp with no Editor offered only unity-cli-status. Open your project in Unity 6+, install the Pipeline package with unity pipeline install and check unity status; the Editor's tools then appear.

Is the Unity MCP server the best way for an agent to use Unity?

Not always. Unity says its direct commands (unity command and unity eval) are faster and use fewer tokens than MCP, so agents with a terminal, like Claude Code and Codex, can use those, often through Unity's agent plugin. MCP is for clients that can't run shell commands.

Can an AI agent import Unity Asset Store packages I own?

Yes, with the community IvanMurzak/Unity-MCP plugin from version 1.11.0 (November 11, 2026): its assetstore-library tool searches your My Assets library and assetstore-add imports a pack by product ID and reports the prefabs, materials and models it added. You need to be signed in to Unity in the Editor, and it only imports packs you already own. Commit first and check the render pipeline before the agent uses the assets. We haven't tested it.

Do community Unity MCP packages still work?

Unity says third-party MCP packages installed from GitHub aren't affected by the deprecation. CoplayDev/unity-mcp (MIT), IvanMurzak/Unity-MCP (Apache-2.0) and CoderGamester/mcp-unity (MIT) were all updated in late October 2026. They're also an option on Editors older than Unity 6.

How do I keep Unity agent skills up to date?

From Unity CLI 1.0.0-beta.16, run unity skill sync [client] to install or update one agent's Unity skills without prompting (it keeps edited copies; with no client it picks the agent running it). unity skill install --all covers every client found. The CLI also suggests sync once a day when an agent runs unity with older skills; UNITY_NO_AGENT_HINTS turns that off. Skills are not MCP — pair sync with unity mcp configure when you want a live Editor.

Free download · one page + PDF · updated weekly, current edition November 16, 2026

📬 Get the VibeStack Weekly + the free AI Game Dev Stack 2026

The best AI tool for each job in a solo or indie game (3D, sprites and pixel art, animation, audio, NPCs), MCP setups for Unity, Unreal, Godot and Roblox, and which free plans you can actually ship with.

Yours free when you join the VibeStack Weekly: new AI game-dev tools and releases every Monday, 5-minute read. Unsubscribe anytime.