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.
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
- Step 1: Install Godot and Node.js 18 or newer.
- Step 2: From your game's folder, run the command at the top of this page.
- Step 3: Restart Claude Code and run
/mcp: godot should be connected. - 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:
claude mcp add godot -e GODOT_PATH=/path/to/godot -e DEBUG=true -- npx @coding-solo/godot-mcpOn macOS the executable is inside the app bundle, for example /Applications/Godot.app/Contents/MacOS/Godot.
What Claude Code can do with it
| Job | Tools |
|---|---|
| Run and stop your game, and read errors | run_project, get_debug_output, stop_project |
| Open the editor on a project | launch_editor |
| Find projects and inspect their structure | list_projects, get_project_info |
| Build scenes | create_scene, add_node, load_sprite, save_scene |
| 3D tiles for GridMap | export_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 see | What 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 connect | Restart Claude Code. Check npx @coding-solo/godot-mcp runs on its own in a terminal. |
| Scene edits do not show in the open editor | Reload 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.
