godot-mcp-enhanced — Claude Code MCP server for Godot projects
Gives an agent 46 MCP tools to read, write, run and verify Godot 4.5–4.7 projects without opening the editor.
claude mcp add --env GODOT_PATH=<GODOT_PATH> --env GODOT_PROJECT_PATH=<GODOT_PROJECT_PATH> --env ALLOWED_PROJECT_PATHS=<ALLOWED_PROJECT_PATHS> --transport stdio godot-mcp-enhanced -- npx -y godot-mcp-enhancedWhat godot-mcp-enhanced does
The server links an AI client to the engine through three layers: headless, editor and game bridge. The agent creates a project, writes scenes and scripts, runs the game and captures a screenshot, then compiles every script after each edit. It ships 46 tools covering 272 actions — scenes, UI, animation, physics, particles, navigation, audio, export.
Verification is the other half. qa boots the real game with a structured test suite and assertions, and playtest.seed locks the random number generator so the same input produces the same result across runs. verify_delivery checks scene tree integrity, script health and performance. The game bridge holds a TCP connection to a running game: it reads the node tree and properties, listens to signals, injects input, records and replays a session.
Security is built in. ALLOWED_PROJECT_PATHS is a deny-by-default whitelist, and the godot_path argument plus project overrides are rejected until GODOT_MCP_ALLOWED_GODOT_PATHS is configured — without that list the agent cannot point at an arbitrary binary, so set it up first if you work in an untrusted environment. Godot itself does not have to be installed beforehand: npx godot-mcp-enhanced install downloads a build and registers it in the search chain.
What it helps with
- build Godot scenes and scripts from a text description
- run a project and get a structured error breakdown
- pin a seed and reproduce a bug across runs
- capture a screenshot or GIF from a running game
- check build readiness before export
Example prompts for the agent
- Create a Godot project and make a scene with a character that jumps on space
- Run the game and show me what errors came up in the console
- Run the qa suite and tell me whether all assertions passed
How to install godot-mcp-enhanced
Platform CLI
claude mcp add --env GODOT_PATH=<GODOT_PATH> --env GODOT_PROJECT_PATH=<GODOT_PROJECT_PATH> --env ALLOWED_PROJECT_PATHS=<ALLOWED_PROJECT_PATHS> --transport stdio godot-mcp-enhanced -- npx -y godot-mcp-enhancedReplace <…> with your own values
Platform CLI
codex mcp add godot-mcp-enhanced --env GODOT_PATH=<GODOT_PATH> --env GODOT_PROJECT_PATH=<GODOT_PROJECT_PATH> --env ALLOWED_PROJECT_PATHS=<ALLOWED_PROJECT_PATHS> -- npx -y godot-mcp-enhancedReplace <…> with your own values
Config file
{
"mcpServers": {
"godot-mcp-enhanced": {
"command": "npx",
"args": [
"-y",
"godot-mcp-enhanced"
],
"env": {
"GODOT_PATH": "<GODOT_PATH>",
"GODOT_PROJECT_PATH": "<GODOT_PROJECT_PATH>",
"ALLOWED_PROJECT_PATHS": "<ALLOWED_PROJECT_PATHS>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"godot-mcp-enhanced": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"godot-mcp-enhanced"
],
"env": {
"GODOT_PATH": "<GODOT_PATH>",
"GODOT_PROJECT_PATH": "<GODOT_PROJECT_PATH>",
"ALLOWED_PROJECT_PATHS": "<ALLOWED_PROJECT_PATHS>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e GODOT_PATH=<GODOT_PATH> -e GODOT_PROJECT_PATH=<GODOT_PROJECT_PATH> -e ALLOWED_PROJECT_PATHS=<ALLOWED_PROJECT_PATHS> godot-mcp-enhanced npx -y godot-mcp-enhancedReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about godot-mcp-enhanced
How do I install godot-mcp-enhanced in Claude Code?
The basic form is claude mcp add godot-mcp-enhanced -- npx -y godot-mcp-enhanced. To pass engine and project paths, use `claude mcp add --env GODOT_PATH=<GODOT_PATH> --env GODOT_PROJECT_PATH=<GODOT_PROJECT_PATH> --env ALLOWED_PROJECT_PATHS=<ALLOWED_PROJECT_PATHS> --transport stdio godot-mcp-enhanced -- npx -y godot-mcp-enhanced`.
What does godot-mcp-enhanced do?
It gives an agent access to a Godot project: reading and writing scenes and scripts, running the game, taking screenshots, running deterministic tests and checking a build before export. It works through three layers — headless, editor and game bridge.
Do I need Godot installed already?
No. npx godot-mcp-enhanced install downloads a build from the official releases and registers it in the search chain and the path whitelist.
