Enables AI agents to inspect and control Godot 4 editor sessions and running games through a WebSocket bridge.
Also known as godotbridge/addon, addon
- Stars
- 5
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.4
- Last commit
- Nov 1, 2026
- License
- MIT
What is GodotBridge MCP?
GodotBridge enables AI agents to inspect and control Godot 4 editor sessions and running games through a WebSocket bridge.
Summary generated from the project's README
About GodotBridge MCP server
GodotBridge provides a connection between AI agents and Godot 4 editor sessions. It uses a local WebSocket bridge to allow clients like Claude, Cursor, or Windsurf to interact with your development environment. Developers install a GDScript plugin directly into their Godot project and run a Python-based MCP server via pip to establish the link. This setup enables an AI to manage both the editor and the active game instance simultaneously.
The system offers 345 tools organized into 36 categories, covering tasks such as scene building, animation, shaders, and physics. It includes a runtime probe that creates a second channel for live inspection of a running game. This allows an agent to simulate input, take screenshots, and perform debugging tasks. Because the plugin is written in pure GDScript, it requires no compilation and works with Godot 4.2 or later.
What you can do with it
- 1Automated scene constructionAn AI agent can build and organize scenes within the Godot editor using specialized tools.
- 2Live game debuggingDevelopers can use an AI to inspect the state of a running game through a dedicated runtime channel.
- 3Simulating player interactionsAn AI client can trigger inputs within a running game session to test mechanics.
Written from the project's README. Every use case is checked against a quote from it.
How to install GodotBridge MCP
Formats verified 10 Nov 2026Install GodotBridge MCP in Claude Code
$ claude mcp add addon -- uvx godotbridgeInstall GodotBridge MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"addon": {
"command": "uvx",
"args": [
"godotbridge"
]
}
}
}Install GodotBridge MCP in VS Code
.vscode/mcp.json
{
"servers": {
"addon": {
"type": "stdio",
"command": "uvx",
"args": [
"godotbridge"
]
}
}
}Install GodotBridge MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"addon": {
"command": "uvx",
"args": [
"godotbridge"
]
}
}
}Install GodotBridge MCP in Codex
~/.codex/config.toml
[mcp_servers.addon] command = "uvx" args = ["godotbridge"]
Install GodotBridge MCP in Gemini CLI
~/.gemini/settings.json
{
"mcpServers": {
"addon": {
"command": "uvx",
"args": [
"godotbridge"
]
}
}
}Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablegodotbridge/addon is public and reachablegithub.com/godotbridge/addon ↗Pass
- Package names this repository as its sourcegodotbridge names https://github.com/godotbridge/releases/releases as its sourcepypi.org/project/godotbridge/ ↗Finding
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-10github.com/godotbridge/addon ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from godotbridgePass
- No critical advisory in the package or its dependencies32 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubGodotBridge — Godot Editor Plugin
The Godot 4.x editor addon for GodotBridge. This plugin creates a local WebSocket bridge that lets an MCP-speaking AI agent (Claude, Cursor, Windsurf, or any MCP client) inspect and control your Godot editor session and running game.
Features
- 345 tools across 36 categories — scene building, animation, shaders, physics, runtime game control, AI Image Studio, and more
- Real-time bridge — WebSocket connection between the editor and the MCP server
- Runtime probe — a second channel to the running game for live inspection, input simulation, screenshots, and debugging
- Zero compilation — pure GDScript, drop-in plugin
Installation
From Godot Asset Library (recommended)
- Open your Godot project
- Go to AssetLib tab
- Search for GodotBridge
- Click Download → Install
- Enable the plugin: Project → Project Settings → Plugins → GodotBridge → Enable
Manual installation
- Download or clone this repository
- Copy the
addons/godot_mcp_bridgefolder into your Godot project'saddons/directory - Enable the plugin: Project → Project Settings → Plugins → GodotBridge → Enable
Setup
This plugin is the editor-side half of GodotBridge. You also need the MCP server to connect your AI agent:
pip install godotbridge
Then register it with your AI client:
Claude Code:
claude mcp add godot-bridge -- godotbridge
Claude Desktop / Cursor / Windsurf:
Add to your MCP config:
{
"mcpServers": {
"godot-bridge": {
"command": "godotbridge"
}
}
}
For detailed setup instructions, visit godotbridge.com.
How it works
Your AI agent (Claude, Cursor, etc.)
│
│ MCP / stdio
▼
GodotBridge MCP Server (Python)
│
│ WebSocket · ws://127.0.0.1:8765
▼
This plugin (Godot editor)
│
│ WebSocket · ws://127.0.0.1:8766
▼
Your running game (runtime probe)
The editor plugin hosts the WebSocket server. The MCP server connects to it as a client — so the bridge survives your AI session ending and reconnects automatically.
Requirements
- Godot 4.2 or later
- GodotBridge MCP server (Python 3.10+)
License
MIT — see LICENSE for details.
Links
GodotBridge MCP questions
How do I add GodotBridge MCP to Claude Code?
Run claude mcp add addon -- uvx godotbridge in your terminal. Add --scope user to make it available in every project.
How do I add GodotBridge MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What are the system requirements?
You need Godot 4.2 or later and the GodotBridge MCP server running on Python 3.10 or higher.
Does the bridge require compilation?
No, the plugin is written in pure GDScript and requires zero compilation.