Add the godot_mcp addon to your C# Godot project and drive the editor with AI.
Godot 4.3+ (.NET build)C# / .NET 8
01
Install the plugin
The desktop app sets the plugin up for you. Prefer to do it yourself? Pick one of the paths below.
Easiest: the AI Game Dev app
Download the desktop app, open your Godot project and click Install Package: it installs the plugin, signs it in and connects your AI agent. No terminal, no Node.js.
Install via the godot-cli tool on npm. install-plugin downloads the godot_mcp addon from the matching GitHub release, adds the NuGet packages and the extension-catalog embed to your .csproj, and enables the plugin — safe to run again.
1Install the CLI
Install godot-cli globally from npm.
npm install -g godot-cli
2Install the plugin
Download the addon, add the NuGet packages to your .csproj, and enable godot_mcp in project.godot.
godot-cli install-plugin ./MyGodotProject
3Wire up your AI client
Generate the MCP config for your client (e.g. Claude Code).
godot-cli setup-mcp claude-code ./MyGodotProject
4Open & wait
Open the project and wait until the editor is ready.
godot-cli open ./MyGodotProject
After opening you can also gate scripts on editor-readiness: godot-cli wait-for-ready ./MyGodotProject.
OR
◆
Asset Library
Install the godot_mcp addon from the Godot Asset Library (or the same zip from GitHub Releases), then add the NuGet packages and enable the plugin.
Search for Godot-MCP in the Godot AssetLib tab, or download the zip from the GitHub Releases page, and place it in your project's addons/ folder.
2Add the NuGet packages
Add the packages the addon needs to your .csproj — com.IvanMurzak.ReflectorNet, com.IvanMurzak.McpPlugin and the code-execution packages — plus the addons/godot_mcp/extensions.catalog.json EmbeddedResource. The installation guide has the exact block with every version.
3Enable the plugin
In the editor: Project → Project Settings → Plugins, then enable Godot-MCP.
4Open & build
Reopen the project so Godot builds the C# solution with the new packages.
02
Connect
Run through the hosted cloud endpoint, or point at your own server.
Using the AI Game Dev app? It installs, signs in and connects the Godot plugin for you, so skip steps 02 and 03 below: they connect your own MCP client, such as Claude Code, Cursor or Copilot.
Cloud
Default
Connect through ai-game.dev using the device-code OAuth flow — no tokens to copy by hand. From the AI Game Developer window choose Cloud, click Authorize, and approve the device code in your browser. Works across firewalls and gives you usage analytics. This is the default and what we recommend for most users.
Custom
Prefer to run everything locally? Point the plugin at your own gamedev-mcp-server instance instead of the hosted endpoint. Your AI client then talks straight to your machine. Client-by-client config snippets live on the MCP endpoint page.
Run this in your project to configure Codex for Godot:
godot-cli setup-mcp codex ./MyGodotProject
Run this in your project to configure Gemini for Godot:
godot-cli setup-mcp gemini ./MyGodotProject
Run this in your project to configure Cline for Godot:
godot-cli setup-mcp cline ./MyGodotProject
Run this in your project to configure Rider (Junie) for Godot:
godot-cli setup-mcp rider-junie ./MyGodotProject
Run this in your project to configure Kilo Code for Godot:
godot-cli setup-mcp kilo-code ./MyGodotProject
Run this in your project to configure Open Code for Godot:
godot-cli setup-mcp open-code ./MyGodotProject
Run this in your project to configure Antigravity for Godot:
godot-cli setup-mcp antigravity ./MyGodotProject
Restart your agent after configuring. The new MCP server is only picked up on a full restart of the agent — quit it completely and reopen it (not just reload the window).
04
First run
Open the window, authorize, and try your first prompt.
1Open the project in the Godot editor and open the AI Game Developer dock.
2Choose Cloud and click Authorize to complete the device-code flow.
3Wait for the status to go green, then connect your AI client.
4Try a prompt like the one below and watch it act in the editor.
Example prompt
Add a Node3D scene with a Camera3D and a MeshInstance3D cube, then save it as Main.tscn.