Godot MCP Pro MCP Server

Premium MCP (Model Context Protocol) server for AI-powered Godot game development. Connects AI assistants like Claude directly to your Godot editor

Local serverstdioPython

What is the Godot MCP Pro MCP server?

Most developer tooling work still happens through a UI a human drives. Godot MCP Pro MCP server moves it into the conversation instead. Premium MCP (Model Context Protocol) server for AI-powered Godot game development. Connects AI assistants like Claude directly to your Godot editor with 175 powerful tools.

The short version

  • UndoRedo Integration — All node/property operations support Ctrl+Z
  • Smart Type Parsing — "Vector2(100, 200)", "#ff0000", "Color(1,0,0)" auto-converted
  • Auto-Reconnect — Exponential backoff reconnection (1s → 2s → 4s ... → 60s max)
  • Heartbeat — 10s ping/pong keeps connection alive
  • Helpful Errors — Error responses include suggestions for next steps

The tools it exposes

The server publishes 14 tools. What each one is for:

  • get_project_info — Project metadata, version, viewport, autoloads
  • get_filesystem_tree — Recursive file tree with filtering
  • search_files — Fuzzy/glob file search
  • get_project_settings — Read project.godot settings
  • set_project_setting — Set project settings via editor API
  • uid_to_project_path — UID → res:// conversion
  • project_path_to_uid — res:// → UID conversion
  • get_scene_tree — Live scene tree with hierarchy
  • get_scene_file_content — Raw .tscn file content
  • create_scene — Create new scene files
  • open_scene — Open scene in editor
  • delete_scene — Delete scene file

What it needs from you

Configuration is passed through the environment: GODOT_MCP_PORT. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Getting it running

The server ships on npm as npm, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

How it compares

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Godot MCP Pro's toolset — get_project_info, get_filesystem_tree, search_files and 11 more — is a fair guide to whether it matches your workflow. It is maintained by youichi-uda; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Godot MCP Pro.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
get_project_infoProject metadata, version, viewport, autoloads
get_filesystem_treeRecursive file tree with filtering
search_filesFuzzy/glob file search
get_project_settingsRead project.godot settings
set_project_settingSet project settings via editor API
uid_to_project_pathUID → res:// conversion
project_path_to_uidres:// → UID conversion
get_scene_treeLive scene tree with hierarchy
get_scene_file_contentRaw .tscn file content
create_sceneCreate new scene files
open_sceneOpen scene in editor
delete_sceneDelete scene file
add_scene_instanceInstance scene as child node
play_sceneRun scene (main/current/custom)

How to install the Godot MCP Pro MCP server

{
  "mcpServers": {
    "godot-mcp-pro": {
      "command": "npx",
      "args": ["-y", "npm"],
      "env": {
        "GODOT_MCP_PORT": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
GODOT_MCP_PORTConfiguration value read at startup.Optional

Example prompts to try

  • Use Godot MCP Pro to get project info.
  • Use Godot MCP Pro to get filesystem tree.
  • Use Godot MCP Pro to search files.

Frequently asked questions

It connects Godot MCP Pro to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (get_project_info, get_filesystem_tree, search_files, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Godot MCP Pro directly.