Godot MCP

claude mcp add godot-mcp -e 'GODOT_PROJECT_PATH=<GODOT_PROJECT_PATH>' -e 'GODOT_PATH=<GODOT_PATH>' -e 'GODOT_MCP_MODE=full' -e 'GODOT_MCP_TOOLSETS=<GODOT_MCP_TOOLSETS>' -e 'GODOT_MCP_READ_ONLY=false' -e 'GODOT_MCP_ALLOW_EVAL=false' -e 'GODOT_MCP_CONFIRM=elicit' -e 'GODOT_MCP_LOG_LEVEL=info' -e 'GODOT_MCP_HEADLESS_TIMEOUT_MS=120000' -e 'GODOT_MCP_BRIDGE_TIMEOUT_MS=30000' -e 'GODOT_MCP_LSP_PORT=<GODOT_MCP_LSP_PORT>' -e 'GODOT_MCP_LSP_TIMEOUT_MS=15000' -e 'GODOT_MCP_LSP_IDLE_MS=600000' -e 'GODOT_MCP_CACHE_DIR=<GODOT_MCP_CACHE_DIR>' -- npx -y @shin2344234/godot-mcp@0.1.2

{
    "mcpServers": {
        "godot-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@shin2344234/godot-mcp@0.1.2"
            ],
            "env": {
                "GODOT_PROJECT_PATH": "<GODOT_PROJECT_PATH>",
                "GODOT_PATH": "<GODOT_PATH>",
                "GODOT_MCP_MODE": "full",
                "GODOT_MCP_TOOLSETS": "<GODOT_MCP_TOOLSETS>",
                "GODOT_MCP_READ_ONLY": "false",
                "GODOT_MCP_ALLOW_EVAL": "false",
                "GODOT_MCP_CONFIRM": "elicit",
                "GODOT_MCP_LOG_LEVEL": "info",
                "GODOT_MCP_HEADLESS_TIMEOUT_MS": "120000",
                "GODOT_MCP_BRIDGE_TIMEOUT_MS": "30000",
                "GODOT_MCP_LSP_PORT": "<GODOT_MCP_LSP_PORT>",
                "GODOT_MCP_LSP_TIMEOUT_MS": "15000",
                "GODOT_MCP_LSP_IDLE_MS": "600000",
                "GODOT_MCP_CACHE_DIR": "<GODOT_MCP_CACHE_DIR>"
            }
        }
    }
}

Environment variables

• GODOT_PROJECT_PATH Folder of the Godot project (the one containing project.godot). Defaults to the folder the client starts the server in, so set it whenever that is not your project (e.g. in desktop apps).
• GODOT_PATH Full path of the Godot 4.x executable (GODOT_BIN is accepted too). If unset, the server looks for godot, godot4 or Godot_v4* on PATH. On Windows use the main Godot exe, not the _console.exe launcher.
• GODOT_MCP_MODE How tools are exposed: 'full' lists every enabled operation as its own tool (best for clients with tool search); 'compact' lists only core tools plus router tools that reach the rest.
• GODOT_MCP_TOOLSETS Comma-separated tool groups to enable, or 'all' (default). Groups: core, files, scene, node, script, run, editor, signal, resource, visual, anim, world, audio, project, import, export, code, docs, game, debug, test. 'core' is always on.
• GODOT_MCP_READ_ONLY Set to true to hide every tool that changes something (inspection only).
• GODOT_MCP_ALLOW_EVAL Set to true to let godot_game_eval run GDScript inside the running game. Off by default: evaluated code can do anything the game can (files, OS calls).
• GODOT_MCP_CONFIRM 'elicit' asks the user (through the client's elicitation dialog, when supported) before irreversible operations; 'never' skips asking, for unattended runs where nobody can answer.
• GODOT_MCP_LOG_LEVEL Verbosity of the server's stderr log (use 'debug' when filing a bug report).
• GODOT_MCP_HEADLESS_TIMEOUT_MS Advanced: timeout for one headless Godot invocation, in milliseconds.
• GODOT_MCP_BRIDGE_TIMEOUT_MS Advanced: timeout for one request to the live editor bridge, in milliseconds.
• GODOT_MCP_LSP_PORT Advanced: port of the Godot editor's GDScript language server on 127.0.0.1. Defaults to the port the editor plugin reports, else 6005.
• GODOT_MCP_LSP_TIMEOUT_MS Advanced: timeout for one GDScript language server request, in milliseconds.
• GODOT_MCP_LSP_IDLE_MS Advanced: stop the private headless language server after this many milliseconds without code tool calls.
• GODOT_MCP_CACHE_DIR Advanced: folder for the server's cache (the Godot class docs index). Defaults to the per-user cache folder of the OS.