Godot MCP Server

MCP server that connects AI coding assistants to the Godot 4.2+ editor (scenes, nodes, scripts, ClassDB, playtests) via the companion

Local serverstdioGo

What is the Godot MCP Server?

MCP server that connects AI coding assistants to the Godot 4.2+ editor (scenes, nodes, scripts, ClassDB, playtests) via the companion godot-mcp-toolkit plugin.

The short version

The number that says the most is 150+ operations. That is the real work on offer: create a node, paint a tilemap cell, key an animation track, read a live node mid-playtest, and roughly a hundred and fifty more. Those operations are packaged into up to 112 tools (an always-on core plus 28 on-demand groups), because a tool is a slot in your client's tool budget and an operation is a thing you can actually do. Related actions sit behind one tool, which keeps the list short while the operation count tells the honest story of breadth. Some operations are version-gated, so older Godot versions (down to

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
animation_authoringKeyframes, tracks, and AnimationTree state machines
asset_opsAsset listing, dependency queries, binary imports
audioAudio buses, effects, and volume settings
classdbGodot class hierarchy: properties, methods, signals, inheritance
cleanupDeleting files, scripts, scenes, resources, folders; closing scenes
debuggerDebugger state, breakpoints, execution flow
editor_advancedEditor screenshots, filesystem refresh, wait-for-idle
input_mapInput actions and their key/controller bindings
layer_namingPhysics, render, and navigation layer names
lsp_code_analysisGDScript diagnostics, symbols, hover, project-wide compile check
lsp_code_navigationCompletion, go-to-definition, find references
navigationNavigation regions, meshes, obstacle avoidance
particlesGPU particle systems

How to install the Godot MCP Server

{
  "mcpServers": {
    "godot-2": {
      "command": "npx",
      "args": ["-y", "@npgamedev/godot-mcp-server"],
      "env": {
        "GODOT_MCP_LSP_HOST": "your-value",
        "GODOT_MCP_PROJECT_PATH": "your-value",
        "GODOT_MCP_TOKEN_PATH": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
GODOT_MCP_LSP_HOSTEndpoint or connection string the server talks to.Optional
GODOT_MCP_PROJECT_PATHFilesystem location the server is allowed to use.Optional
GODOT_MCP_TOKEN_PATHCredential the server authenticates with.Yes

Example prompts to try

  • “Use Godot to Group.”
  • “Use Godot to animation authoring.”
  • “Use Godot to asset ops.”

Frequently asked questions

MCP server that connects AI coding assistants to the Godot 4.2+ editor (scenes, nodes, scripts, ClassDB, playtests) via the companion godot-mcp-toolkit plugin. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.