Files
..

Godot AI

Connect AI assistants to a live Godot editor via the Model Context Protocol (MCP).

Godot AI bridges Claude Code, Codex, Antigravity, and other MCP clients with your editor — inspect scenes, create nodes, modify properties, run tests, search project files, and more, all from a prompt.

Quick Start

  1. Copy addons/godot_ai/ into your project's addons/ folder
  2. Enable the plugin: Project > Project Settings > Plugins > Godot AI
  3. Pick your MCP client in the Godot AI dock and press Configure

The plugin auto-starts the MCP server and connects over WebSocket. No manual configuration required.

Requirements

  • Godot 4.3+ (4.4+ recommended)

  • uv (used to install the Python server)

    Install uv

    macOS / Linux:

    curl -LsSf https://astral.sh/uv/install.sh | sh
    

    Windows (PowerShell):

    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
    

    Homebrew (macOS / Linux):

    brew install uv
    

    pipx:

    pipx install uv
    

    See the uv install docs for more options.

  • An MCP client (Claude Code | Codex | Antigravity)

Documentation

Full documentation, contributing guide, and source code: github.com/hi-godot/godot-ai

License

MIT