Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add godotbridge -- uvx godotbridge
Open on GitHub

What 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 godotbridge

uvx 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.

Similar MCP servers

All MCP servers for Game dev and 3D: Unity, Unreal, Godot, Blender →

Project sponsors

Companies that keep this analytics open