godot-mcp — Claude Code MCP server: what it does, how to install
Connects AI assistants directly to the Godot 4.4+ editor to inspect and edit scenes, nodes, and scripts without switching windows.
claude mcp add godot-mcp -- npx -y godot-mcp-serverWhat godot-mcp does
The server bridges clients like Claude Code or Cursor to a running Godot instance over a local WebSocket on port 6505. Running it requires Node.js and the godot_mcp plugin placed inside the project's addons/ folder. Once enabled in Project Settings, Godot displays an active agent badge in the upper right corner.
It provides 32 tools handling scene setup, script updates, directory inspection, and input map queries. The agent can attach collision shapes, adjust node properties, and validate GDScript syntax. In addition, the map_project action serves an interactive script relationship visualizer in the browser at localhost:6510.
Native Ctrl+Z inside Godot will not revert edits applied by the assistant because changes write directly to disk. Rollbacks require asking the agent to trigger the mcp_undo tool. The setup operates strictly on localhost and attaches to one Godot editor at a time.
What it helps with
- inspect and manipulate Godot scene trees directly through the AI assistant
- edit GDScript files with syntax validation without manual copy-pasting
- explore script connections and signals via an interactive browser graph
- read project settings and collision layers straight from the running editor
Example prompts for the agent
- Add a CharacterBody2D node with a collision shape to the current scene and create a movement script.
- Run map_project to visualize script dependencies at localhost:6510.
- Revert the last change made to the player scene using mcp_undo.
How to install godot-mcp
Platform CLI
claude mcp add godot-mcp -- npx -y godot-mcp-serverPlatform CLI
codex mcp add mcp-server -- npx -y godot-mcp-serverConfig file
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"godot-mcp-server"
]
}
}
}Config file
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"godot-mcp-server"
]
}
}
}Platform CLI
gemini mcp add mcp-server npx -y godot-mcp-serverStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about godot-mcp
How do I install godot-mcp in Claude Code?
Install Node.js first, then run claude mcp add godot-mcp -- npx -y godot-mcp-server. After that, place the godot_mcp addon into your Godot project's addons/ directory and enable it under Project Settings.
What does godot-mcp do?
It establishes a bridge between MCP-compatible assistants and Godot 4.4+. This lets the AI read live project state, create scenes, modify node properties, and edit scripts while the editor runs.
Why does Godot's Ctrl+Z not undo changes made by the AI?
The plugin writes modifications directly to disk instead of pushing them into Godot's live undo stack. To roll back an action, ask your agent to run the mcp_undo tool.
