# GodotBridge

GodotBridge MCP server connects AI agents to the Godot editor to build, run, and test game projects.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: godotbridge
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/godotbridge/addon
- Updated: 2026-11-01
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/godotbridge

## What it 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.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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>

### Codex

**Platform CLI**
```bash
codex mcp add godotbridge -- uvx godotbridge
```
uvx runs the command named after the package; if the README names another one, use uvx --from godotbridge <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add godotbridge uvx godotbridge
```
uvx runs the command named after the package; if the README names another one, use uvx --from godotbridge <command>

## When to use it
- 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
- Add a sprite node to the active scene
- Run the project and check player physics
- Take a screenshot of the current game frame

## Similar
- [scenario-godot-multiplayer](https://affpapa.org/en/nevibecode/skills/scenario-godot-multiplayer.md) — skill · 431 installs
- [add-multiplayer](https://affpapa.org/en/nevibecode/skills/add-multiplayer.md) — skill · 702 installs
- [audio-design](https://affpapa.org/en/nevibecode/skills/audio-design.md) — skill · 14200 installs
- [dialogue-systems](https://affpapa.org/en/nevibecode/skills/dialogue-systems.md) — skill · 13000 installs
- [godot-master](https://affpapa.org/en/nevibecode/skills/godot-master.md) — skill · 5500 installs
- [make-game](https://affpapa.org/en/nevibecode/skills/make-game.md) — skill · 1200 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
