Godot MCP Runtime

A lightweight, zero-footprint TypeScript MCP server that lets AI assistants drive the Godot 4.x game engine. It provides headless editing capabilities for scenes, nodes, scripts, and signals, as well as runtime control including screenshots, input simulation, UI discovery, and live GDScript execution against the running scene tree. This allows agents to create, validate, and play-test games without requiring a Godot addon or project commits.

Package and access

Local package with source-attributed installation metadata. Koskamo does not execute packages during review.

Community listingLocal stdioSource reviewed; not executedPublished by Erodenn

Vendor documentation

Checks and signals

Each line is separate evidence, not a trust score.

Popularity 96 GitHub stars

What you can do with it

Create scenes, add nodes, and set properties headlessly
Attach scripts and connect signals in Godot projects
Run the game project and take screenshots for verification
Simulate input and execute live GDScript against the scene tree

Source and maintenance

Community listingRegistry 3.8.0MIT

mcp-registry: io.github.Erodenn/godot-mcp-runtime@3.8.0 Source repository

Last repository push: Oct 30, 2026, 3:42 AM UTC
Latest release: v3.8.1
Maintenance checked: Nov 2, 2026, 4:27 PM UTC

Packages and installation

Source-provided package data. Koskamo has not executed or live-probed this package.

godot-mcp-runtime 3.8.0

npmnpx

godot-mcp-runtime package definition

{
  "version": "3.8.0",
  "transport": "stdio",
  "identifier": "godot-mcp-runtime",
  "runtimeHint": "npx",
  "registryType": "npm",
  "registryBaseUrl": "https://registry.npmjs.org",
  "environmentVariables": [
    {
      "name": "GODOT_PATH",
      "description": "Path to the Godot 4.x executable. Auto-detected if Godot is on PATH."
    },
    {
      "name": "DEBUG",
      "description": "Enable verbose logging when set to 'true'."
    },
    {
      "name": "GODOT_MCP_DISABLE_ELICITATION",
      "description": "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."
    },
    {
      "name": "GODOT_MCP_STRICT",
      "description": "Set to 'true' to hard-reject anything that would otherwise prompt, for unattended operation. Takes precedence over GODOT_MCP_DISABLE_ELICITATION."
    },
    {
      "name": "GODOT_MCP_DISABLE_SECURITY",
      "description": "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."
    }
  ]
}

Tools

Reported by the attributed source; not independently observed by Koskamo.

No tool definitions available.

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

Nov 2, 2026, 4:27 PM UTC · repository · passed · metadata changed · updated
Nov 2, 2026, 4:27 PM UTC · backfill · recorded · Pre-expansion baseline; unobserved rich metadata remains unknown

Connect from your client

Each snippet configures the same source-provided package; replace placeholders before use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Cursor

Merge this local stdio configuration, replace every placeholder environment value, and restart Cursor. Koskamo has not executed this package.

Cursor configuration

{
  "mcpServers": {
    "godot-mcp-runtime": {
      "command": "npx",
      "args": [
        "-y",
        "godot-mcp-runtime@3.8.0"
      ],
      "env": {
        "GODOT_PATH": "<YOUR_GODOT_PATH>",
        "DEBUG": "<YOUR_DEBUG>",
        "GODOT_MCP_DISABLE_ELICITATION": "<YOUR_GODOT_MCP_DISABLE_ELICITATION>",
        "GODOT_MCP_STRICT": "<YOUR_GODOT_MCP_STRICT>",
        "GODOT_MCP_DISABLE_SECURITY": "<YOUR_GODOT_MCP_DISABLE_SECURITY>"
      }
    }
  }
}

Cline

Merge this local stdio configuration, replace every placeholder environment value, and restart Cline. Koskamo has not executed this package.

Cline configuration

{
  "mcpServers": {
    "godot-mcp-runtime": {
      "command": "npx",
      "args": [
        "-y",
        "godot-mcp-runtime@3.8.0"
      ],
      "env": {
        "GODOT_PATH": "<YOUR_GODOT_PATH>",
        "DEBUG": "<YOUR_DEBUG>",
        "GODOT_MCP_DISABLE_ELICITATION": "<YOUR_GODOT_MCP_DISABLE_ELICITATION>",
        "GODOT_MCP_STRICT": "<YOUR_GODOT_MCP_STRICT>",
        "GODOT_MCP_DISABLE_SECURITY": "<YOUR_GODOT_MCP_DISABLE_SECURITY>"
      }
    }
  }
}

VS Code

Merge this local stdio configuration, replace every placeholder environment value, and restart VS Code. Koskamo has not executed this package.

VS Code configuration

{
  "servers": {
    "godot-mcp-runtime": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "godot-mcp-runtime@3.8.0"
      ],
      "env": {
        "GODOT_PATH": "<YOUR_GODOT_PATH>",
        "DEBUG": "<YOUR_DEBUG>",
        "GODOT_MCP_DISABLE_ELICITATION": "<YOUR_GODOT_MCP_DISABLE_ELICITATION>",
        "GODOT_MCP_STRICT": "<YOUR_GODOT_MCP_STRICT>",
        "GODOT_MCP_DISABLE_SECURITY": "<YOUR_GODOT_MCP_DISABLE_SECURITY>"
      }
    }
  }
}

Claude Desktop

Merge this local stdio configuration, replace every placeholder environment value, and restart Claude Desktop. Koskamo has not executed this package.

Claude Desktop configuration

{
  "mcpServers": {
    "godot-mcp-runtime": {
      "command": "npx",
      "args": [
        "-y",
        "godot-mcp-runtime@3.8.0"
      ],
      "env": {
        "GODOT_PATH": "<YOUR_GODOT_PATH>",
        "DEBUG": "<YOUR_DEBUG>",
        "GODOT_MCP_DISABLE_ELICITATION": "<YOUR_GODOT_MCP_DISABLE_ELICITATION>",
        "GODOT_MCP_STRICT": "<YOUR_GODOT_MCP_STRICT>",
        "GODOT_MCP_DISABLE_SECURITY": "<YOUR_GODOT_MCP_DISABLE_SECURITY>"
      }
    }
  }
}

Let your agent find its tools

Find servers like Godot MCP Runtime from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows

See all 7,692