Exaro for Godot
Install the add-on, connect your AI, and let it build, play and check your game in the open editor.
Works with your Claude Code or Codex subscription. Don't have one? Install Claude Code or Codex.
Requirements
- Godot 4.7 or newer. On an older editor the add-on shows one message asking you to update and does nothing else.
- Windows is the tested platform. macOS and Linux should work but are not yet tested.
- For the Exaro dock: Claude Code or Codex, signed in to your subscription. No API key. How to set it up.
- Or any MCP client that can connect over HTTP and send a custom header.
Install
The Exaro Installer is the easiest way: close Godot, connect your account, click Install next to Exaro for Godot and choose your project folder. Then skip to the last step below. To install by hand:
- Sign in and download the add-on from your library. It is free.
- Copy
addons/exaro_studiointo your project'saddons/folder. - In Godot, open Project › Project Settings › Plugins and enable Exaro Studio. This also adds the
ExaroGameBridgeautoload, which lets the editor capture the running game. It does nothing in exported builds. - Check the Output panel for
[ExaroStudio] MCP server listening on http://127.0.0.1:8790/mcp.
Connect your AI
Exaro works with the AI subscription you already have. Install Claude Code or Codex, sign in once, and Exaro uses it. No API key needed.
Using Exaro Studio? It can install either for you: click Set up on Your AI, then Install for me. It runs the maker's own installer, then opens the sign-in.
Other ways to install
Claude Code from Command Prompt:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdOr with winget install Anthropic.ClaudeCode, or with Node.js: npm install -g @anthropic-ai/claude-code.
Codex with Node.js: npm install -g @openai/codex.
- Install one of them, with Exaro Studio or the command above.
- Sign in: in the Exaro tool's Connect your AI panel, click Sign in to Claude or Sign in to ChatGPT (Codex). Your browser opens; sign in there. If Claude shows a code, paste it into the box Exaro shows.
- Open the Exaro dock in Godot. It finds Claude Code and Codex by itself and uses your subscription, Claude Code first; the selector beside Send switches between them. If it finds neither, the dock shows a Connect your AI panel with a Check again button, so you don't need to restart Godot.
Advanced: sign in from a terminal
If the sign-in button doesn't work for you, open a new terminal and run claude auth login or codex login, then click Check again in the Exaro tool.
Advanced: use an API key instead
The Exaro dock runs on Claude Code or Codex and never uses an API key. To work some other way, including with an app that uses an API key, connect that app to the add-on's MCP server as in Connect another AI client.
Use the Exaro dock
The Exaro dock sits on the right of the editor. Type what you want in plain English and it carries it out in the open editor. It runs your own Claude Code or Codex, pointed only at this editor, with their file and shell tools switched off so the work goes through the editor. Chat is free on every plan.
Connect another AI client
Each editor takes the first free port from 8790 to 8799, or the port in EX_MCP_PORT if you set one. Every request needs the X-Exaro-MCP-Token header. For Claude Code, add this to .mcp.json:
{
"mcpServers": {
"exaro-godot": {
"type": "http",
"url": "http://127.0.0.1:8790/mcp",
"headers": {
"X-Exaro-MCP-Token": "<contents of .godot/exaro/mcp.token>"
}
}
}
}The token changes each time the editor starts, so paste the current contents of .godot/exaro/mcp.token. Each running editor also writes ~/.exaro/godot/<port>.json with its project and token file, so a script can find the right editor. That file is removed when the editor closes.
What your AI can do
Tool names match Exaro for Unreal wherever the idea is the same: a level is a scene and an actor is a node. Every edit goes through the editor's undo history, so Ctrl+Z works on your AI's changes.
| Area | What it covers |
|---|---|
| Scenes and nodes | Create, open and save scenes. Spawn, move, change and delete nodes, including nested children in one call. |
| Scripts | Create, read and edit GDScript. Every script is parse-checked, and an edit that does not parse is refused. |
| Seeing | Frame a node, draw temporary markers and take screenshots of the editor viewport or the running game. |
| Playing | Start and stop the game, hold actions and keys, aim at a node, and inspect nodes while it runs. |
| Assets | Search, import, rename, duplicate and delete. Renames carry references with them, and an asset in use will not be deleted. |
| 2D | TileSets, painted tile maps and SpriteFrames. |
| Look | Materials, particles, lighting, post-processing, fog, parallax, cameras and game feel. |
| Animation and UI | Animation clips, state machines, HUDs, menus, themes and signal connections. |
| Gameplay | Playable characters, enemies, projectiles, trigger volumes, saves, data tables and dialogue. |
| Levels | Build from a text layout, audit for problems with their fixes, take snapshots and verify navigation paths. |
| Exaro Drawing and Sound | Run either app headless and import sprite sheets, tile maps and sound banks into the project. |
| Marketplace | Search the public catalogue and import what you own. |
Image generation (optional)
Image generation is off until you turn it on in the Exaro dock under Settings. Choose ComfyUI, free on your own GPU, or Gemini with your own Google API key, billed by Google per image. The Test button checks the setup without spending anything. Every other tool works without it.
Plans and licence
- The core editor tools are free, and you do not need a licence key to use them.
- Exaro Studio uses one licence key across every engine. Enter it on the dock's Licence page.
- After activating, the add-on works offline for up to 30 days past its last check.
- Only
addons/exaro_studio/runtime/may ship inside your exported games.
Not in the beta yet
- Buying from the marketplace inside the editor.
- Chat history across editor restarts.
- Gemini in the dock. It can still connect as an MCP client where it supports it.
- Physics joints and ragdolls, shader graphs, level sequences, networking and terrain.
Troubleshooting
- The add-on only asks you to update. Your editor is older than Godot 4.7.
- A client connected yesterday but is refused today. The token changed when the editor restarted. Copy the new one from
.godot/exaro/mcp.token. - A client reaches the wrong project. Each open editor has its own port. Check the Output panel, or the files in
~/.exaro/godot/. - The dock will not answer. Check that Claude Code or Codex is installed (Connect your AI), then in the dock's Connect your AI panel click Sign in to Claude or Sign in to ChatGPT (Codex) and finish in your browser, then Check again.
Support
Licence keys, activation, refunds and bugs: [email protected]. Include your Godot version, your add-on version and, for a bug, the steps and the Output panel text.