Godot MCP

Launch, run and debug Godot projects, and read the output.

Started in our test
★ 6.4K GitHub stars
4.8K downloads a week
Last commit 16 Apr 2026

At a glance

Godot MCP gives an assistant the parts of the Godot workflow that need the engine: open the editor, run the project, capture the debug output, and create or change scenes and nodes. The agent can then fix a script and run again without you switching windows.

It finds Godot on the usual install paths; set GODOT_PATH if yours is elsewhere.

Made by: Solomon Elias (Coding-Solo)
Licence: MIT
Latest version: 0.1.1 (3 Feb 2026)
npm package: @coding-solo/godot-mcp
GitHub stars: 6.4K
Downloads: 4.8K a week
Last commit: 16 Apr 2026
Tools: 14
Runs on: Your computer

Our check: We ran this exact config on 26 Oct 2026: it started and answered with 14 tools.

What's in the pod: its tools

We found 14 tools when we started it on 26 Oct 2026. 5 only read. The rest can change things, so keep your app's "ask before each tool call" setting on for them.

Runs commands1 tool · Can start programs or run code.

Tool	What it is for
`run_project`	Starts the game in debug mode, or a single scene, and starts capturing its output.

Changes things8 tools · Can create, edit, send or delete.

Tool	What it is for
`add_node`	Adds a node of any type to a scene and sets its properties.
`create_scene`	Makes a new .tscn scene with the root node type you choose.
`export_mesh_library`	Turns a scene of 3D meshes into a MeshLibrary for GridMap level building.
`launch_editor`	Opens the Godot editor on a project.
`load_sprite`	Puts a texture onto a Sprite2D node.
`save_scene`	Saves a scene, or saves it under a new name.
`stop_project`	Stops the running game.
`update_project_uids`	Re-saves resources so their id references are current after upgrading to Godot 4.4.

Only reads5 tools · Looks things up and changes nothing.

Tool	What it is for
`get_debug_output`	Collects the console output and errors from the game that is running.
`get_godot_version`	Reports which Godot version is installed.
`get_project_info`	Summarises a project: its name, scenes, scripts and resources.
`get_uid`	Looks up the unique id Godot 4.4 and later gives a file.
`list_projects`	Finds Godot projects inside a folder.

Grouped and described by us. The README on GitHub lists the inputs each tool takes.

Set it up

Pick your app for the exact snippet and where it goes.

Where it goes: claude_desktop_config.json (Settings → Developer → Edit Config)

Claude Desktop

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": [
        "-y",
        "@coding-solo/godot-mcp"
      ]
    }
  }
}

Where it goes: Your terminal, in the project folder

Claude Code

claude mcp add-json godot '{"command":"npx","args":["-y","@coding-solo/godot-mcp"]}'

Where it goes: ~/.cursor/mcp.json, or .cursor/mcp.json in a project

Cursor

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": [
        "-y",
        "@coding-solo/godot-mcp"
      ]
    }
  }
}

Where it goes: .vscode/mcp.json in your project

VS Code

{
  "servers": {
    "godot": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@coding-solo/godot-mcp"
      ]
    }
  }
}

Where it goes: ~/.codeium/windsurf/mcp_config.json

Windsurf

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": [
        "-y",
        "@coding-solo/godot-mcp"
      ]
    }
  }
}

Add "env": { "GODOT_PATH": "/path/to/godot" } if Godot is not in a standard location.

New to this? See the setup guides for Claude Code, Cursor, Claude Desktop and ChatGPT.

Settings

Names are exactly as the project spells them. Required ones are marked.

Setting	What it does
`GODOT_PATH`Environment variable	Full path to the Godot program. Only needed when it is not found on its own.`/Applications/Godot.app/Contents/MacOS/Godot`
`DEBUG`Environment variable	Set to true to log what the server does, for tracking down problems.`true`

What it can touch

It can read

Godot projects on your computer, their scenes and files
Console output from games it starts

It can change

Creates and edits .tscn scene files and resources
Starts and stops the Godot editor and your game

Safer setup: Keep the project in git so you can see and undo every scene change the agent makes.

Before you start

Godot 4 installed
Node.js 18 or newer

If it does not work

Godot cannot be found: Set GODOT_PATH to the Godot executable itself, not the folder it sits in.
Invalid project path: Point it at the folder that holds project.godot.
The agent cannot see errors from the game: Start the game with run_project, then ask for get_debug_output. Games started by hand are not captured.

Peas in a pod: similar servers

How Godot MCP lines up against other design, 3d and games servers on the shelf.

Server	Tools	Runs on	Licence	Stars
Godot MCP	14	Your computer	MIT	6.4K
KiCad MCP	244	Your computer	–	3K
MiniMax	8	Your computer	MIT	1.6K
Blender MCP	9	Your computer	MIT	32.4K
Framelink Figma MCP	2	Your computer	MIT	16.1K