Skip to content
MCP Shelf

Pod to App: Claude Code

How to install Godot MCP in Claude Code

By Sophie Filer · Updated 11 Nov 2026 · Steps checked against Godot MCP's own docs on 11 Nov 2026

The short answer

Run claude mcp add godot -- npx @coding-solo/godot-mcp and restart Claude Code. If Godot is not found automatically, add -e GODOT_PATH=/path/to/godot to the command.

Terminal
claude mcp add godot -- npx @coding-solo/godot-mcp
Needs
Godot, Node.js 18+
Runs on
Your machine
Sign-in
None
Price
Free, MIT

Install it step by step

  1. Step 1: Install Godot and Node.js 18 or newer.
  2. Step 2: From your game's folder, run the command at the top of this page.
  3. Step 3: Restart Claude Code and run /mcp: godot should be connected.
  4. Step 4: Ask: "Run this project, then show me any errors from the debug output." Claude Code launches the game and reads the console.

Tell it where Godot lives

The server tries to find Godot by itself. If it cannot, or you have several versions, set the path when you add it. DEBUG=true turns on detailed logs while you get it working:

Terminal
claude mcp add godot -e GODOT_PATH=/path/to/godot -e DEBUG=true -- npx @coding-solo/godot-mcp

On macOS the executable is inside the app bundle, for example /Applications/Godot.app/Contents/MacOS/Godot.

What Claude Code can do with it

JobTools
Run and stop your game, and read errorsrun_project, get_debug_output, stop_project
Open the editor on a projectlaunch_editor
Find projects and inspect their structurelist_projects, get_project_info
Build scenescreate_scene, add_node, load_sprite, save_scene
3D tiles for GridMapexport_mesh_library
Fix UID references (Godot 4.4 and later)get_uid, update_project_uids

The loop that makes it worthwhile: Claude Code edits a GDScript file, runs the project, reads the debug output, and fixes what broke, without you copying errors back and forth.

If it does not work

What you seeWhat to do
"Godot not found"Set GODOT_PATH to the Godot executable, as above.
"Invalid project path"Point it at a folder that contains project.godot.
godot will not connectRestart Claude Code. Check npx @coding-solo/godot-mcp runs on its own in a terminal.
Scene edits do not show in the open editorReload the scene in Godot; the server edits files on disk.

MCP Shelf take

Is Godot MCP worth adding to Claude Code?

For Godot work in Claude Code, the big win is the run-and-read loop: the agent can start your game and see the same errors you would, which turns guesswork into actual debugging. Scene tools are handy for scaffolding levels and UI, though complex scenes are still faster to build by hand in the editor. It is light to install and has no account or key. If you write GDScript with Claude Code, add it; if you only use the visual editor, you will get less from it.

Sophie Filer

Questions

Does Godot MCP work with Godot 3 and Godot 4?

The README lists features for current Godot, and the UID tools need Godot 4.4 or later. Point GODOT_PATH at the version your project uses.

Can Claude Code see my game running?

It can run the project and read the debug console output, which is where errors and print statements go. It does not watch the game window.

Do I have to keep the Godot editor open?

No. The server calls Godot from the command line for most jobs, and can launch the editor when you ask it to.

Sources: the steps on this page are written in our own words from Godot MCP's own install docs, the README. If they disagree with this page, the project's docs win; please tell us from the server page.