RELATED 01
Godot MCP
Drives an open Godot 4 editor: scenes, nodes, GDScript, project settings and test runs of the game
451GitHub stars
820/wknpm downloads
53popularity score
Godot MCP
Lets an assistant launch the Godot editor, run projects, read debug output and edit scenes.
By Solomon Elias (individual) TypeScript Local · stdio Developer toolsMedia
84 popularity score ★ 6.6k ↓ 40k/wk
Connect your client
Local (npm)
Add in one click
Opens the app, which asks before it adds the server.
Or add it by command or config
Claude CodeTerminal
claude mcp add godot -- npx -y @coding-solo/godot-mcpClaude Desktopclaude_desktop_config.json
{
"mcpServers": {
"godot": {
"command": "npx",
"args": [
"-y",
"@coding-solo/godot-mcp"
]
}
}
}Cursor~/.cursor/mcp.json
{
"mcpServers": {
"godot": {
"command": "npx",
"args": [
"-y",
"@coding-solo/godot-mcp"
]
}
}
}VS Code.vscode/mcp.json
{
"servers": {
"godot": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@coding-solo/godot-mcp"
]
}
}
}Codex~/.codex/config.toml
[mcp_servers.godot]
command = "npx"
args = ["-y", "@coding-solo/godot-mcp"]Gemini CLITerminal
gemini mcp add --scope user godot npx -- -y @coding-solo/godot-mcpSettings 2
GODOT_PATH |
Optional: Path to the Godot executable (overrides automatic detection). |
|---|---|
DEBUG |
Optional: Set to "true" to enable detailed server-side debug logging. |
What it does
Godot MCP connects an AI assistant to a locally installed Godot game engine. It can open the Godot editor for a project, run a project in debug mode, capture its console output and error messages, and stop it again, so the assistant gets direct feedback on whether its changes work.
It also works on project files: listing Godot projects in a directory, reporting a project's structure, creating scenes with a chosen root node type, adding nodes with properties, loading textures into Sprite2D nodes, exporting 3D scenes as MeshLibrary resources and saving scenes or scene variants. For Godot 4.4 and later it can read file UIDs and update UID references by resaving resources.
Simple operations call Godot's own command-line interface; more complex ones run a bundled GDScript file (godot_operations.gd) through Godot. It needs Godot installed on the same machine and Node.js 18 or later, and runs with npx from the @coding-solo/godot-mcp package. GODOT_PATH can point it at the Godot executable when automatic detection fails.
What it needs
| Runtime | Node.js |
|---|
Tools 14
launch_editor- Open the Godot editor for a specific project
run_project- Run a Godot project in debug mode
get_debug_output- Retrieve console output and error messages from the running project
stop_project- Stop a running Godot project
get_godot_version- Retrieve the installed Godot version
list_projects- Find Godot projects in a specified directory
get_project_info- Get detailed information about a project's structure
create_scene- Create a new scene with a specified root node type
add_node- Add a node with properties to an existing scene
load_sprite- Load a sprite or texture into a Sprite2D node
export_mesh_library- Export a 3D scene as a MeshLibrary resource for GridMap
save_scene- Save a scene, optionally as a variant
get_uid- Get the UID for a specific file (Godot 4.4+)
update_project_uids- Update UID references by resaving resources (Godot 4.4+)