godot-ai

What it is and what it does

Godot AI is a production-grade MCP server that bridges AI assistants and LLM clients directly into a live Godot editor instance. It exposes approximately 43 MCP tools with over 120 operations, allowing Claude Code, Codex, Grok Build, Antigravity, and other AI clients to programmatically build scenes, edit nodes and scripts, wire signals, and configure UI, materials, animations, particles, cameras, and environments—all without manual editor interaction.

The package runs as a Python server (built on fastmcp, uvicorn, starlette, websockets, pydantic, and httpx) that the Godot plugin communicates with over WebSocket. Installation involves adding the plugin to your Godot project's addons folder, enabling it in Project Settings, then configuring your MCP client to connect to the local HTTP endpoint. The dock provides one-click auto-configuration for most popular clients and manual setup instructions for others.

Use it for:

• Rapidly prototype game scenes and UI layouts by describing them to Claude Code or another AI client without manually placing nodes.
• Automate repetitive editor tasks like creating node hierarchies, wiring signals, or applying material configurations through natural-language prompts.
• Build and test game logic by having an AI assistant write and execute GDScript directly in the editor, with access to the scene tree and project files.
• Generate game content (voxel worlds, procedural levels, save systems) by orchestrating multiple MCP operations in sequence via a single high-level prompt.
• Run in-editor test suites written as McpTestSuite GDScript tests, allowing AI clients to validate game behavior and iterate on implementations.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Godot AI exposes a Model Context Protocol (MCP) server that lets AI assistants and LLM clients directly control a live Godot editor, building scenes, editing nodes and scripts, and configuring game assets through over 120 operations across approximately 43 MCP tools.

Yes, with conditions. The package is actively maintained, has low install friction, and offers a genuinely novel workflow for AI-assisted game development in Godot. However, verify the license terms before use in commercial projects (license treatment is unclear), and confirm that the 43 tools and 120+ operations cover your intended use cases. If you work with Godot 4.5+ and use Claude Code, Codex, or similar AI clients, this is worth trying; otherwise, check whether your MCP client is listed in the supported clients.

Install

godot-ai on PyPI

pip install godot-ai

uv add godot-ai

poetry add godot-ai

Installing godot-ai

Before you install

Low friction: pure Python wheel with six runtime dependencies (fastmcp, websockets, pydantic, httpx, uvicorn, starlette). Active maintenance—released 3 days ago with 1669 GitHub stars and a commit history through 2026-08-14. Requires Python 3.11+.

License in practice

License treatment is unclear—no SPDX identifier or raw license text provided in metadata. Verify the project's repository or LICENSE file before adopting in commercial or proprietary work.

Quickstart

# Install via uv (recommended for the Python server)
uv pip install godot-ai

# Or via pip
pip install godot-ai

# Then in Godot: Project > Project Settings > Plugins, enable Godot AI
# Configure your MCP client (Claude Code, Codex, etc.) via the dock

# Example manual Claude Code setup:
# claude mcp add --scope user --transport http godot-ai http://127.0.0.1:8000/mcp

Requires Godot 4.5+ (4.7+ recommended) and uv or pip for the Python server. MCP client (Claude Code, Codex, Antigravity, etc.) must be installed and configured separately.

Verify before relying

• Whether the unclear license permits commercial use or redistribution without restrictions.
• Exact scope and stability guarantees of the 120+ operations across the 43 MCP tools.
• Performance and latency characteristics when controlling complex scenes or large projects.

Package facts

Evidence: godot_ai-3.1.5-py3-none-any.whl

Keywords: godot, godot-engine, mcp, model-context-protocol, ai, llm, gamedev, editor-plugin

Tags

More Python Modules packages

Further reading