How to use AI with Godot: MCP servers, Claude Code and editor plugins (2026)

Godot doesn't have AI built in: the Godot 4.7 release notes don't mention any AI features, and Godot 4.7.2 (August 18, 2026) is the current stable version. To use AI with Godot, you connect an outside tool. There are three kinds, and most people combine two of them:

• A coding agent such as Claude Code, Codex or Cursor, which edits your project's .gd and .tscn files.
• An MCP server, which gives that agent controls for Godot itself: run the project, read the errors, add nodes and, with some servers, see the running game.
• An editor plugin that puts a chat assistant inside the Godot editor.

This guide covers which to pick, how to set up the most common combination (Claude Code plus a Godot MCP server), and how to make the agent check its own work. Prices and versions are as of November 7, 2026.

Godot MCP servers compared

MCP (Model Context Protocol) is a standard way for an AI agent to call another program's functions. A Godot MCP server turns Godot's actions into tools the agent can call, then reads back the result, so the agent can run your game and see what broke instead of guessing. (Our guide to MCP servers for Unreal, Godot and Minecraft explains the idea in more detail.)

Servers come in two designs. Headless servers drive Godot from outside through its command line, so nothing is installed in the editor. Plugin servers run an add-on inside the open editor, which lets them do more (screenshots, live node inspection, simulated input) but means the editor has to be running.

A few notes on the table:

• Coding-Solo's godot-mcp is the most popular by far. It works through Godot's own command line plus a bundled GDScript helper, so it runs without an editor plugin. Its README lists launching the editor, running a project in debug mode, capturing debug output, creating scenes, adding nodes, loading sprites and saving scenes. It needs Node.js 18 or later. Its last commit, on April 16, 2026, fixed a security issue in how it adds nodes, so install from the repo if you want that fix; the npm package was last updated in February.
• Godot MCP Pro keeps only its editor add-on on GitHub, under the MIT license; the README says the server itself is proprietary and comes with the paid package on itch.io ($15 or more, one-time, with lifetime updates).
• GDAI MCP sells a $19 one-time license on its site. Its README says you may use it in commercial games but shouldn't commit the plugin to a public repository.
• Several older servers, including ee0pdt's Godot-MCP (621 stars, last updated March 2025), haven't been updated in months. Check a repo's last commit before you depend on it.

How to set up Claude Code with Godot

This is the shortest path to an agent that can build and run a Godot 4 game. The same steps work with Codex or Cursor; only the command for adding an MCP server differs.

1. Install Godot 4.7 and make sure the godot command runs from your terminal (on macOS and Windows that means adding it to your PATH).
2. Add the MCP server. Coding-Solo's README gives the one-line setup for Claude Code: claude mcp add godot -- npx @coding-solo/godot-mcp. Restart Claude Code and ask it to list its Godot tools to confirm they loaded.
3. Tell the agent about your project. Put the Godot version, your folder layout and your naming rules in CLAUDE.md (or AGENTS.md for Codex). Say plainly that the project is Godot 4, not Godot 3 (see "Limits" below for why).
4. Ask for small, checkable changes: "add a dash ability to the player, then run the project and fix any errors," rather than "make my game."
5. Make it check its own work with the commands in the next section after every change.

If you'd rather start from a template than an empty project, Godogen (MIT, 7,298 stars) sets up a game repo for Claude Code or Codex with instructions and skills, then has the agent build the game, generate assets, run the engine and record a video as proof. It supports Godot 4 with GDScript or C#. Skill packs add Godot know-how to an agent you already use: Awesome Gamedev Agent Skills (Apache-2.0) includes 16 Godot skills written for Godot 4.7, and Claude Code Game Studios (MIT) includes a Godot specialist agent.

How to make the agent check its own work

One of the most useful habits with AI in Godot is letting it test what it writes. Godot's command line, documented in the official 4.7 docs, gives an agent three useful checks without opening the editor:

• Find script errors: godot --headless --check-only --script res://path/to/script.gd. The docs describe --check-only as parsing for errors and quitting, used together with --script. One catch, noted in the tugcantopaloglu godot-mcp README: scripts that use autoload singletons can show false "Identifier not found" errors this way.
• Run a scene: godot --path . res://scenes/level_1.tscn, adding --quit-after 300 to stop after a set number of iterations (frames) so the agent isn't left waiting.
• Export a build: godot --headless --export-release "Web" build/index.html uses an export preset you've already set up.

For gameplay logic, add a test framework the agent can run:

• GUT (Godot Unit Test) runs from the command line with godot -d -s --path "$PWD" addons/gut/gut_cmdln.gd, plus -gdir for the test folder and -gexit to quit when done. GUT 9 is the version for Godot 4; for Godot 4.7, the README points to GUT 9.7.1 on its godot_4_7 branch.
• GdUnit4 (MIT) tests GDScript and C# and runs with ./addons/gdUnit4/runtest.sh -a <test folder>, once the GODOT_BIN environment variable points to your Godot binary. Version 6.2 supports Godot 4.5 to 4.7.1.

Put the exact test command in CLAUDE.md and ask the agent to run it before it says a task is done. For checks that need eyes on the game, such as whether a sprite faces the right way, use an MCP server that takes screenshots. Our guide on letting coding agents playtest games covers that loop.

AI assistants inside the Godot editor

If you'd rather chat inside the editor than work from a terminal, these plugins put an assistant there:

• AI Assistant Hub (free, MIT): connects to local models through Ollama or llama.cpp, and to Google Gemini, OpenRouter or xAI. With Ollama or llama.cpp it can read and write code and nodes in the editor; with the others it's chat only. It recommends Godot 4.7.
• Ziva (from Zivash Inc.): an in-editor agent for Godot 4.2 and later that can use Claude, GPT or Gemini, local models through Ollama or LM Studio, or your own Claude Code or Codex account. Its Hobby plan is free with your own provider; Basic costs $20 a month for models it hosts. It also runs a local MCP server.
• Fuku (free, MIT): a chat assistant supporting Ollama, OpenAI, Claude and Gemini, aimed at Godot 4.5; last updated October 2025.

Godot Copilot, an early plugin you may find in search results, still lists GPT-3.5-era OpenAI models and hasn't been updated since April 2024.

Running AI inside your Godot game

The tools above help you make a game. A separate set puts AI into the game itself, for example NPCs that talk:

• NobodyWho runs open models locally through llama.cpp, with tool calling, on desktop and Android. It's licensed under EUPL-1.2. Its README notes there's no iOS export for the Godot version.
• Player2 provides AI NPC nodes for Godot that use Player2's AI APIs, which it says are free; you need a client ID from player2.game. The Godot plugin is GPL-3.0.

Our AI NPCs guide compares the wider field.

Limits and caveats

• Models still write Godot 3 code by mistake. Much of the GDScript online is for Godot 3, and the APIs changed. A benchmark published by Flockbay, which makes a Godot-based AI game maker with paid plans, lists typical mistakes such as using KinematicBody2D (renamed CharacterBody2D in Godot 4), passing arguments to move_and_slide(), and writing export var without the @. In its 15-task test on Godot 4.7.2 (one run per model, October 6, 2026), Claude Opus 5.5, Claude Sonnet 5.5 and GPT-6.1 Sol passed all 15 tasks and Claude Haiku 4.5 passed 11 on the first try; in a wider run on its blog, 12 of 28 models passed all 15 first time. It's a vendor's small test, not independent research, but it matches why the --check-only step above matters.
• The Godot project doesn't accept AI-written engine code. A Godot Foundation post on June 30, 2026 says "We require all code to be human authored" for contributions to the engine, allowing AI only for small jobs like code completion, with disclosure. That rule covers pull requests to Godot itself, not games you make with it.
• Plugin servers change your editor. Godlink's README warns that Ctrl+Z doesn't undo the AI's changes (it has its own undo tool), so commit to git before each agent session.
• Check licenses for commercial work. Most servers here are free and open source, but the paid servers for Godot MCP Pro and GDAI MCP are proprietary, and IvanMurzak's plugin depends on a package under the PolyForm Shield license.
• AIGamer hasn't tested these tools. This guide compares what each project says about itself.

How we chose

AIGamer compiled this guide from each project's README, website or store page and from Godot's official documentation and blog, all opened on November 7, 2026. Star counts and update dates come from GitHub on that day. We included MCP servers updated in 2026 with working setup instructions, and noted older ones separately. Developers already building Godot games this way include the makers of Courtside Crew: Pickleball and After the Wind.

FAQ

Does Godot have built-in AI?

No. The Godot 4.7 release notes don't announce any AI features. You add AI with an outside tool: a coding agent, an MCP server or an editor plugin.

What is Godot MCP?

It's a server that lets an AI agent control Godot through the Model Context Protocol: run your project, read its errors and edit scenes. The best-known is Coding-Solo's open-source godot-mcp; several others add screenshots and simulated input.

Is Godot MCP free?

Most Godot MCP servers are free and open source, including Coding-Solo's godot-mcp and Godlink MCP (both MIT). Godot MCP Pro costs $15 or more one-time, and GDAI MCP costs $19 one-time.

Can Claude Code make a Godot game?

Yes. Claude Code can write GDScript and scene files directly, and with a Godot MCP server it can also run the project and read the errors. Godogen sets up a project so Claude Code or Codex can build a whole Godot 4 game, unattended if you like.

Which AI is best for GDScript?

There's no independent benchmark yet. In one vendor's 15-task Godot 4.7 test, 12 of 28 models passed every task first time, among them Claude Opus 5.5, Claude Sonnet 5.5 and GPT-6.1 Sol. Whatever you use, tell it you're on Godot 4 and have it run --check-only on its scripts.

Can I use AI in the Godot editor with a local model?

Yes. AI Assistant Hub and Fuku both work with Ollama, and Ziva supports Ollama and LM Studio, so your code doesn't have to leave your machine (Ziva notes that some of its other features may use online services).