godot-mcp (satelliteoflove)

Agent skill by satelliteoflove · for Claude Code, Claude Desktop, GitHub Copilot and Any MCP client

A free MIT MCP server and Godot 4.5+ addon that lets Claude Code, Copilot and other agents edit scenes, tilemaps and animations, then run the game, inject input, step game time and read live state to playtest their own changes.

  • Engine: Godot 4.5+
  • 4 agents
  • License: MIT
  • Free
  • 187 stars

Install

npx @satelliteoflove/godot-mcp --install-addon /path/to/your/godot/project

Run 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

Browse all 74 agent skills