The problem
How it works
godot-mcp is an MIT-licensed MCP server for the Godot engine. It gives an agent tools to launch the editor, run a project in debug mode, capture errors and console output, stop the run, inspect project structure, create scenes, add nodes, load sprites, save scenes and manage UIDs in Godot 4.4 and later. Setup is a one-line claude mcp add for Claude Code, or a JSON configuration for Cline, Cursor and other clients.
Results and limitations
The README describes tools and setup without reported outcomes. Its main point is the feedback loop: running the game and reading the debug output lets the agent check its own changes.
Before you try it
You need Godot and Node.js 18 or later; set GODOT_PATH if the server cannot find Godot. The Cline example auto-approves every tool and the Cursor notes suggest an auto-run mode; keep approvals on for scene-editing tools and use version control so you can roll back. Results depend on your setup and were not independently reproduced by Top 200 Repos.
Tools and repositories
- Tools
- Godot Engine · godot-mcp (Node.js 18 or later) · Claude Code, Cursor or Cline
- Prerequisites
- Godot installed locally, Node.js 18 or later, and an MCP-capable agent.
Try it yourself: Prototype a Godot scene in checked steps
Fill the fields to adapt the prompt. Empty fields stay as visible [placeholders].
In the Godot project at [Project folder], build a minimal prototype of [Game idea]. Before editing, show me the project structure and your plan, and confirm the project is under version control with a clean commit. Work in small steps: after each step run the project in debug mode, read the output and fix any errors before continuing. Put new assets only in [Folder for new assets] and do not delete existing scenes or scripts. Stop after [Maximum steps] steps and summarise what works, what failed and what I should test by hand.Commit before each session so any scene the agent breaks can be restored.
Sources
- Coding-Solo/godot-mcp README (opens in a new tab)
Project documentation · github.com · Undated · Source checked 11 Nov 2026, 22:04 UTC
What this source supports
- Launches the Godot editor, runs projects and captures debug output
- Creates scenes, adds nodes, loads sprites and saves scenes
- UID tools for Godot 4.4 and later
- Setup instructions for Claude Code, Cline and Cursor
- Requires Godot and Node.js 18 or later; GODOT_PATH overrides detection
- MIT licence