▄████████  ▄██████▄  ███▄▄▄▄   ████████▄  ███    █▄   ▄█      ███    
                  ███    ███ ███    ███ ███▀▀▀██▄ ███   ▀███ ███    ███ ███  ▀█████████▄
                  ███    █▀  ███    ███ ███   ███ ███    ███ ███    ███ ███▌    ▀███▀▀██
                  ███        ███    ███ ███   ███ ███    ███ ███    ███ ███▌     ███   ▀
                  ███        ███    ███ ███   ███ ███    ███ ███    ███ ███▌     ███    
                  ███    █▄  ███    ███ ███   ███ ███    ███ ███    ███ ███      ███    
                  ███    ███ ███    ███ ███   ███ ███   ▄███ ███    ███ ███      ███    
                  ████████▀   ▀██████▀   ▀█   █▀  ████████▀  ████████▀  █▀      ▄████▀  

                                A simple and fast MCP server for Unity.

A Unity MCP server that stays out of the way of your coding agent.

• Robust: survives crashes, restarts, assembly reloads, and handles multiple agents and Unity instances.
• Context-efficient: conserves the agent's context window and saves tokens. Small number of versatile tools.
• Simple setup: one Unity package, one server exe, automated setup wizard. No dependencies, no pollution.
• Supports Linux and Windows, both in the editor and in development builds.

[!WARNING] Granting an AI agent access to Unity indirectly gives them escalated access to your machine. Agents may be able to perform actions outside the regular sandbox through Unity. Have a backup strategy, and make sure your work machine is resilient to data loss.

Installation

1. Install the Unity package

• Window ⟶ Package Manager ⟶ + ⟶ Install package from git URL
• Paste this URL (the release branch points at the latest commit that passed all tests)

https://github.com/apkd/Conduit.git?path=/Conduit.Unity#release

• Or you can also declare it directly in Packages/manifest.json instead:

"dependencies": {
  "dev.tryfinally.conduit": "https://github.com/apkd/Conduit.git?path=/Conduit.Unity#release",

2a. Just use the setup wizard

[!TIP] The Unity package includes a wizard for setting up the MCP server. This lets you download the server executable and configure your installed code editors in just a few clicks.

You can find the setup wizard in Unity here:

Edit → Preferences... → Conduit

2b. Install the MCP server

[!TIP] If you used the setup wizard, you can skip this step.

First, you need to grab the MCP server executable, and put it in your project (for a project-local installation) or some stable location on your computer (for a user-level setup).

<details> <summary><b>Windows</b></summary>

Download conduit-win-x64.exe and move it to the location where you want to keep it. For example, this PowerShell command installs it as conduit.exe in your user profile:

New-Item -ItemType Directory -Force "$HOME\Conduit"
Invoke-WebRequest "https://github.com/apkd/Conduit/releases/latest/download/conduit-win-x64.exe" -OutFile "$HOME\Conduit\conduit.exe"
Unblock-File "$HOME\Conduit\conduit.exe"

</details> <details> <summary><b>Linux</b></summary>

Download conduit-linux-x64, place it in the location where you want to keep it, and make it executable. For example, these commands install it as conduit in ~/.local/bin:

mkdir -p "$HOME/.local/bin"
curl -fL "https://github.com/apkd/Conduit/releases/latest/download/conduit-linux-x64" -o "$HOME/.local/bin/conduit"
chmod +x "$HOME/.local/bin/conduit"

</details> <details> <summary><b>NixOS</b></summary>

Conduit supports Linux x64 and includes .NET. With nix-command and flakes enabled, you can try it or install it:

nix run github:apkd/Conduit -- --version
nix profile add github:apkd/Conduit#conduit

For your NixOS or Home Manager configuration, add Conduit to your flake:

inputs.conduit.url = "github:apkd/Conduit";

Put inputs.conduit.packages.x86_64-linux.default in environment.systemPackages or home.packages, then rebuild. Configure your MCP client to run conduit.

If you'd like an HTTP server, add these entries to your Home Manager module list:

inputs.conduit.homeManagerModules.default
{
  services.conduit = {
    enable = true;
  };
}

Apply your Home Manager configuration, then point your MCP client at http://127.0.0.1:5080. The service starts and stops automatically with your desktop session. You can change the port with services.conduit.port. Authentication is optional. To enable it, set services.conduit.tokenFile to a token file path as described below and configure the client to send it as a bearer token. Alternatively, set tokenSha256File to the absolute path of a token fingerprint file as described below. Set protectProcess = true on Linux to protect Conduit's memory and turn off its .NET diagnostics.

Install Unity Hub (unityhub) separately if you'd like Conduit to launch Unity. You can connect to an editor you've already opened without Hub.

To update a flake installation, run nix flake update conduit and rebuild your configuration. For profile installations, run nix profile upgrade <entry>; nix profile list shows the entry name.

</details> <details> <summary><b>Manual build instructions</b></summary>

Install the .NET 10 SDK for your operating system. Then clone this repository and publish the server:

dotnet publish Conduit.Server/Conduit.csproj -c Release

The executable is written to Conduit.Server/publish/win-x64/conduit.exe on Windows or Conduit.Server/publish/linux-x64/conduit on Linux.

</details>

3. Configure your code editor

[!TIP] If you used the setup wizard, you can skip this step.

Replace the executable paths in the examples below with the path where you installed the MCP server.

<details> <summary><h4>Select your editor...</h4></summary> <details> <summary>Codex</summary>

Configure the MCP server in either location:

• Unity project: .codex/config.toml. Codex loads this file after the project is trusted.
• User account: %USERPROFILE%\.codex\config.toml on Windows, or ~/.codex/config.toml on Linux.

stdio | Windows (Native)

[mcp_servers.unity]
command = "C:\\src\\Conduit\\Conduit.Server\\publish\\win-x64\\conduit.exe"
args = []
cwd = "C:\\src\\Conduit"
disabled_tools = []
tool_timeout_sec = 300
enabled = true

stdio | Windows (WSL)

[mcp_servers.unity]
command = "/mnt/c/src/Conduit/Conduit.Server/publish/win-x64/conduit.exe"
args = []
cwd = "/mnt/c/src/Conduit"
disabled_tools = []
tool_timeout_sec = 300
enabled = true

stdio | Linux

[mcp_servers.unity]
command = "/home/you/src/Conduit/Conduit.Server/publish/linux-x64/conduit"
args = []
env_vars = ["XDG_RUNTIME_DIR"]
cwd = "/home/you/src/Conduit"
disabled_tools = []
tool_timeout_sec = 300
enabled = true

http

conduit --http [--port 5080] [--url http://127.0.0.1:5080]

codex mcp add unity --url http://127.0.0.1:5080

approve tool calls

To avoid going insane from having to approve every tool call separately:

[mcp_servers.unity]
tools.discard_scenes.approval_mode = "approve"
tools.execute_code.approval_mode = "approve"
tools.find_missing_scripts.approval_mode = "approve"
tools.find_references_to.approval_mode = "approve"
tools.from_json_overwrite.approval_mode = "approve"
tools.get_dependencies.approval_mode = "approve"
tools.help.approval_mode = "approve"
tools.playmode.approval_mode = "approve"
tools.editmode.approval_mode = "approve"
tools.profiler_browse.approval_mode = "approve"
tools.profiler_overview.approval_mode = "approve"
tools.profiler_record.approval_mode = "approve"
tools.project_settings.approval_mode = "approve"
tools.record.approval_mode = "approve"
tools.refresh_asset_database.approval_mode = "approve"
tools.reimport_assets.approval_mode = "approve"
tools.reflect.approval_mode = "approve"
tools.restart.approval_mode = "approve"
tools.run_tests_editmode.approval_mode = "approve"
tools.run_tests_player.approval_mode = "approve"
tools.run_tests_playmode.approval_mode = "approve"
tools.save_scenes.approval_mode = "approve"
tools.screenshot.approval_mode = "approve"
tools.search.approval_mode = "approve"
tools.show.approval_mode = "approve"
tools.status.approval_mode = "approve"
tools.to_json.approval_mode = "approve"
tools.view_burst_asm.approval_mode = "approve"
tools.view_il.approval_mode = "approve"

</details> <details> <summary>Claude Code</summary>

Configure the MCP server in either location:

• Unity project: .mcp.json.
• User account: %USERPROFILE%\.claude.json on Windows, or ~/.claude.json on Linux.

The commands below create the Unity project configuration. Replace --scope project with --scope user to configure the User account instead.

stdio | Windows (Native)

claude mcp add --scope project --transport stdio unity -- C:\src\Conduit\Conduit.Server\publish\win-x64\conduit.exe

stdio | Windows (WSL)

claude mcp add --scope project --transport stdio unity -- /mnt/c/src/Conduit/Conduit.Server/publish/win-x64/conduit.exe

stdio | Linux

claude mcp add --scope project --transport stdio unity -- /home/you/src/Conduit/Conduit.Server/publish/linux-x64/conduit

http

conduit --http [--port 5080] [--url http://127.0.0.1:5080]

Add the server to your private user configuration:

{
  "mcpServers": {
    "unity": {
      "type": "http",
      "url": "http://127.0.0.1:5080"
    }
  }
}

</details> <details> <summary>Claude Desktop</summary>

Claude Desktop keeps one MCP configuration for the User account:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json, or the equivalent path under XDG_CONFIG_HOME

stdio | Windows (Native)

{
  "mcpServers": {
    "unity": {
      "type": "stdio",
      "command": "C:\\src\\Conduit\\Conduit.Server\\publish\\win-x64\\conduit.exe",
      "args": []
    }
  }
}

stdio | Linux

{
  "mcpServers": {
    "unity": {
      "type": "stdio",
      "command": "/home/you/src/Conduit/Conduit.Server/publish/linux-x64/conduit",
      "args": []
    }
  }
}

http

Claude Desktop's Custom Connectors are reached through Anthropic's cloud and cannot connect directly to a server on localhost. Use the local stdio configuration above for Conduit.

<