npx @satelliteoflove/godot-mcp --install-addon /path/to/your/godot/projectRun it in a terminal, then start a new agent session so the skill loads. Read the repo's README and scripts before you install: skills run with your agent's permissions.
What it does
godot-mcp is an MCP server paired with a Godot editor addon. Besides the usual scene and node editing, it is built so an AI agent can check its own work: it can run the game, play it with simulated input and read back what actually happened instead of relying on you to send screenshots and error logs.
Its 21 tools cover opening and saving scenes, reading and editing nodes, editor state and screenshots, animations down to keyframes, TileMapLayer and GridMap cells, resources, 3D transforms and bounding boxes, version-matched Godot docs, input injection (actions, joypad, keys, mouse-look, text), profiler metrics, live game state as JSON, freezing and stepping the game clock, and running GDScript inside the running game to set up test scenarios. Read and write tools are split, so read-only tools can be auto-allowed while edits stay gated.
You add it to your MCP client as an npx command and install the addon into your project with the package's install-addon command, then enable it in Project Settings. It needs Godot 4.5 or later and Node.js 20 or later.
Features
- Run the game and inject real input: actions, joypad, keys, mouse-look, text
- Freeze and step game time, or step until a condition is true
- Live game state as structured JSON, so fewer screenshots are needed
- Edit scenes, nodes, animations, TileMapLayer and GridMap cells
- Version-matched Godot docs and profiler snapshots
- Read-only tools are separated so they can be auto-allowed
Limits
- Needs Godot 4.5 or later and Node.js 20+
- New scenes are created by writing .tscn files, not through a dedicated tool
- The agent must support MCP
Similar skills and which to pick
- Godlink MCPPick Godlink MCP for undo/redo on every change, all-or-nothing batch edits and a browser map of your scripts and scenes; it supports Godot 4.4 and newer.
- Fennara Godot AIPick Fennara for script diagnostics, scene validation and runtime logs, plus an optional in-editor chat dock with your own key or a local model; both need Godot 4.5 or newer.