Godot MCP

Install

Pin version registry version 0.1.2

npm
npx -y @shin2344234/godot-mcp

npm
npx -y @shin2344234/[email protected]

Setup by client

Pick your client — the config below is generated for this server (local stdio). Copy respects the “Pin version” switch above.

{
  "mcpServers": {
    "godot-mcp-shin2344234": {
      "command": "npx",
      "args": [
        "-y",
        "@shin2344234/godot-mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "godot-mcp-shin2344234": {
      "command": "npx",
      "args": [
        "-y",
        "@shin2344234/[email protected]"
      ]
    }
  }
}

claude mcp add godot-mcp-shin2344234 -- npx -y @shin2344234/godot-mcp

claude mcp add godot-mcp-shin2344234 -- npx -y @shin2344234/[email protected]

{
  "mcpServers": {
    "godot-mcp-shin2344234": {
      "command": "npx",
      "args": [
        "-y",
        "@shin2344234/godot-mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "godot-mcp-shin2344234": {
      "command": "npx",
      "args": [
        "-y",
        "@shin2344234/[email protected]"
      ]
    }
  }
}

{
  "servers": {
    "godot-mcp-shin2344234": {
      "command": "npx",
      "args": [
        "-y",
        "@shin2344234/godot-mcp"
      ]
    }
  }
}

{
  "servers": {
    "godot-mcp-shin2344234": {
      "command": "npx",
      "args": [
        "-y",
        "@shin2344234/[email protected]"
      ]
    }
  }
}

{
  "mcpServers": {
    "godot-mcp-shin2344234": {
      "command": "npx",
      "args": [
        "-y",
        "@shin2344234/godot-mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "godot-mcp-shin2344234": {
      "command": "npx",
      "args": [
        "-y",
        "@shin2344234/[email protected]"
      ]
    }
  }
}

Environment variables

Defined in the server's official registry manifest. Required secrets are shown as <YOUR_…> placeholders in the configs above.

• 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. 'cor
• 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).

About this server