Godot MCP Runtime MCP Server

by erodennio.github.Erodenn/godot-mcp-runtimev3.8.0

Control running Godot 4 games via an injected bridge: input simulation, screenshots, UI discovery and live GDScript execution.

84Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active10d ago

Install Godot MCP Runtime MCP server

claude mcp add godot-mcp-runtime -- npx -y godot-mcp-runtime

{
  "mcpServers": {
    "godot-mcp-runtime": {
      "command": "npx",
      "args": [
        "-y",
        "godot-mcp-runtime"
      ]
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "godot-mcp-runtime": {
      "command": "npx",
      "args": [
        "-y",
        "godot-mcp-runtime"
      ]
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "godot-mcp-runtime": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "godot-mcp-runtime"
      ]
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "godot-mcp-runtime": {
      "command": "npx",
      "args": [
        "-y",
        "godot-mcp-runtime"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
GODOT_PATH	—	—	Path to the Godot 4.x executable. Auto-detected if Godot is on PATH.
DEBUG	—	—	Enable verbose logging when set to 'true'.
GODOT_MCP_DISABLE_ELICITATION	—	—	Set to 'true' to disable run_project/run_script confirmation prompts (fail-open) for clients that cannot display elicitation, e.g. Claude Desktop. Tier 1 security hard-blocks still apply.
GODOT_MCP_STRICT	—	—	Set to 'true' to hard-reject anything that would otherwise prompt, for unattended operation. Takes precedence over GODOT_MCP_DISABLE_ELICITATION.
GODOT_MCP_DISABLE_SECURITY	—	—	Set to 'true' to disable the run_script/run_project static gate entirely, Tier 1 hard blocks included. Overrides GODOT_MCP_STRICT. Operator opt-out, not a convenience.