GodotBridge — Claude Code MCP server: what it does, how to install
GodotBridge MCP server connects AI agents to the Godot editor to build, run, and test game projects.
MIT ★ 5 updated 2026-11-01
claude mcp add godotbridge -- uvx godotbridgeWhat GodotBridge does
The tool bridges the game editor and AI clients via a WebSocket connection, enabling direct inspection of the workspace and running runtime. It features 345 tools across 36 categories, covering scene construction, physics, shaders, animations, and graphic controls.
The system relies on a pure GDScript editor plugin and a Python server component. Setup requires Godot 4.2 or newer, alongside Python 3.10+ and the godotbridge package.
Installation requires adding the plugin folder into the addons/ directory of your project and enabling it through the project settings.
What it helps with
- build and modify scenes inside the Godot editor via AI
- inspect the running game state in real time
- control physics, animations, and shaders through chat commands
- simulate runtime input and capture screenshots
Example prompts for the agent
- Add a sprite node to the active scene
- Run the project and check player physics
- Take a screenshot of the current game frame
How to install GodotBridge
Platform CLI
claude mcp add godotbridge -- uvx godotbridgeuvx runs the command named after the package; if the README names another one, use uvx --from godotbridge <command>
Platform CLI
codex mcp add godotbridge -- uvx godotbridgeuvx runs the command named after the package; if the README names another one, use uvx --from godotbridge <command>
Config file
{
"mcpServers": {
"godotbridge": {
"command": "uvx",
"args": [
"godotbridge"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from godotbridge <command>
Config file
{
"servers": {
"godotbridge": {
"type": "stdio",
"command": "uvx",
"args": [
"godotbridge"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from godotbridge <command>
Platform CLI
gemini mcp add godotbridge uvx godotbridgeuvx runs the command named after the package; if the README names another one, use uvx --from godotbridge <command>
Step 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 GodotBridge
How to install GodotBridge in Claude Code?
Run the command claude mcp add godotbridge -- uvx godotbridge in your terminal.
What does GodotBridge do?
GodotBridge creates a WebSocket connection between AI agents and the Godot editor, letting assistants inspect and control your game via 345 tools.
What is needed to run GodotBridge?
You need Godot 4.2 or later, Python 3.10+, and the GodotBridge MCP server package installed and registered in your client configuration.