LibreAI / AI Agents / godot-ai
// agents · hi-godot/godot-ai

godot-ai

Production-grade MCP server for Godot — let AI build scenes, edit scripts and wire your game live

★ 2.9k stars⑂ 168 forksMITupdated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

godot-ai is an open-source ai agents project by hi-godot (hi-godot/godot-ai on GitHub). It has 2,864 GitHub stars and 168 forks, is released under the MIT license, and was last updated on GitHub on 8 October 2026.

GitHub stars
2,864
Forks
168
License
MIT
Last updated on GitHub
8 October 2026
Category
AI Agents
Listing
Full install guide
// how it works

How it works

  1. Clarify your goal

    Decide what you want the AI to do in your Godot project: create a scene, write GDScript, wire signals, or build a whole prototype.

  2. Get Godot AI

    Download a published release from GitHub Releases and place the add-on at your-project/addons/godot_ai/ with plugin.cfg inside.

  3. Enable and configure

    Enable Godot AI under Project → Project Settings → Plugins, then press Configure in its dock for your MCP client and restart that client.

  4. Run your first task

    Ask your client to show the scene hierarchy or create a Camera3D, then build up to a playable prototype.

// features

Why people love it

46 tools, 120+ operations

A large tool surface for scenes, nodes, scripts, signals, UI, materials, animation, particles, cameras and environments.

Live editor connection

The MCP client talks through godot-ai attach (stdio) to an authenticated Python server and the editor plugin — changes happen in the running editor.

GDScript fully supported

Scripts written through the tools are parse-validated, hot-reloaded, attached and outlined; C# is text-only (no .NET build/error reporting).

Many MCP clients

The dock can configure Claude Code, Claude Desktop, Codex, Antigravity, Hermes Agent, Cursor, VS Code and others.

Authenticated local hops

Both local hops use rotating capabilities and stay loopback-only; telemetry can be disabled with GODOT_AI_DISABLE_TELEMETRY=true.

One-click updates

Click Update in the dock when offered; client entries you own are re-pinned automatically after updates.

Advertisement
// run it

Run it yourself

  1. Clone the repo

    Clone Godot AI for development from source; end users should install a release add-on instead (see step 2).

    git clone https://github.com/hi-godot/godot-ai.git
    cd godot-ai
  2. Install the add-on

    Place a published release at addons/godot_ai/ in your project, with plugin.cfg inside that directory, then enable it in Project Settings → Plugins.

    # download a release from https://github.com/hi-godot/godot-ai/releases — see README for the exact package
  3. Connect your client

    In the Godot AI dock press Configure for your MCP client (uv/uvx required for the Python server), restart the client, and try 'Show me the current scene hierarchy.'

    # see README for the exact command — use the dock-generated godot-ai attach command
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains Godot AI?

It is maintained by hi-godot and contributors on GitHub.

Is Godot AI free?

Yes — the README describes it as totally free, and the code is MIT-licensed. Godot itself is also free and open source.

Does it need a paid API key?

It works through your MCP client (Claude Code, Codex, Cursor, etc.), so model costs depend on that client's plan or key.

How does it compare to a generic code assistant?

A code assistant only edits text files. Godot AI operates the live editor — scenes, nodes, signals and project settings — through 46 purpose-built tools.

How do I get started?

You need Godot 4.7+, uv, and an MCP client: install the release add-on into addons/godot_ai/, enable the plugin, and press Configure in the dock.

// keep exploring

Similar tools

AI Agents

unity-mcp

Bridge AI assistants to the Unity Editor via MCP: manage assets, scenes, scripts and tasks.

★ 14.8k starsMIT
View guide →
AI Agents

exa-mcp-server

Exa's MCP server for web search and crawling — give your AI agent a live, high-quality web index.

★ 5.1k starsMIT
View guide →
AI Agents

jadx-ai-mcp

JADX plugin + MCP server that lets LLMs analyze Android APKs live — decompile, review, find vulnerabilities

★ 2.9k starsApache-2.0
View guide →
AI Agents

github-mcp-server

GitHub's official MCP server — let AI tools work with repos, issues and pull requests

★ 33.4k starsMIT
View guide →
AI Agents

n8n-mcp

An MCP server that lets Claude, Cursor and Windsurf build n8n workflows for you

★ 23.0k starsMIT
View guide →
AI Agents

excel-mcp-server

Excel MCP Server: let AI agents read, write, format, and chart real .xlsx workbooks — no Excel required

★ 4.2k starsMIT
View guide →
// alternatives

Alternatives in AI Agents

The most-starred other AI Agents projects in the LibreAI catalogue — the realistic shortlist if godot-ai is not the right fit.

Get godot-ai

Free and open — grab the source, star the repo, and start creating.