Godot MCP — Claude Code MCP server: control Godot
Connects an AI assistant to a Godot project to edit scenes and settings, check scripts, and control a running game. Useful for game development and debugging through agent requests.
claude mcp add godot-mcp -- npx -y @tugcantopaloglu/godot-mcpWhat Godot MCP does
The server gives an assistant tools to work with a Godot project: read and edit scenes, files, and settings, create resources, and manage autoloads. GDScript checks cover syntax and type errors. It can also create a project or script in C#.
When a game is running, the assistant can inspect and change node properties, call methods, switch scenes, manage signals, and fetch errors and logs. Godot 4.4 or later is required; the server was tested with Godot 4.7. That version requirement matters: the listed operations may not work with an older Godot release.
What it helps with
- check GDScript for syntax and type errors
- change a node’s properties in a scene
- configure actions and keys in
project.godot - fetch errors and logs from a running game
- create a Godot project with a C# script
Example prompts for the agent
- Check this project’s scripts for syntax and type errors.
- Read
main.tscnand change the player node’s properties. - Fetch new errors and logs while the game is running.
How to install Godot MCP
Platform CLI
claude mcp add godot-mcp -- npx -y @tugcantopaloglu/godot-mcpPlatform CLI
codex mcp add godot-mcp -- npx -y @tugcantopaloglu/godot-mcpConfig file
{
"mcpServers": {
"godot-mcp": {
"command": "npx",
"args": [
"-y",
"@tugcantopaloglu/godot-mcp"
]
}
}
}Config file
{
"servers": {
"godot-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@tugcantopaloglu/godot-mcp"
]
}
}
}Platform CLI
gemini mcp add godot-mcp npx -y @tugcantopaloglu/godot-mcpStep 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?
Run claude mcp add godot-mcp -- npx -y @tugcantopaloglu/godot-mcp.
What does Godot MCP do?
It connects an AI assistant to project operations and a running Godot game. The server can edit scenes and settings, check scripts, and control nodes at runtime.
Which Godot version does Godot MCP require?
It requires Godot 4.4 or later. The server was tested with Godot 4.7.
