Godot AI
A MCP server integration for Godot Engine that allows Claude, Cursor, Windsurf, VSCode, etc to perform actions like creating scenes, resources, scripts, reading errors and much more.
What is Godot AI?
Godot AI is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server integration for godot engine that allows claude, cursor, windsurf, vscode, etc to perform actions like creating scenes, resources, scripts, reading errors and much more.
A MCP server integration for Godot Engine that allows Claude, Cursor, Windsurf, VSCode, etc to perform actions like creating scenes, resources, scripts, reading errors and much more.
This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A MCP server integration for Godot Engine that allows Claude
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx gdai-mcp-plugin-godotConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Godot AI
The GDAI MCP Plugin for Godot is a Godot Engine plugin that runs a local MCP server inside your Godot project, allowing AI coding assistants like Claude, Cursor, and VS Code Copilot to interact directly with your game project. Through the MCP connection, AI clients can create scenes, nodes, and scripts; read and fix GDScript errors; search project assets; capture editor screenshots; and inspect the project structure — all without leaving their IDE. This makes it possible to use natural language to build and debug Godot games with full access to the live editor state.
Prerequisites
- Godot Engine 4.1 or later
- uv (Python package manager) installed: https://docs.astral.sh/uv/getting-started/installation/
- An MCP-compatible AI client: Claude Desktop, Cursor, VS Code with Copilot/Cline, or Windsurf
- The GDAI MCP Plugin zip downloaded from the GitHub releases page
Install uv (Python runner)
The MCP server component is a Python script run via uv. Install uv using the appropriate command for your OS.
# 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"Install the Godot plugin
Close the Godot editor, download the latest plugin zip from the GitHub releases page, extract it, and copy the addons/gdai-mcp-plugin-godot/ folder into your project's res://addons/ directory.
# Copy the plugin folder to your project
cp -r addons/gdai-mcp-plugin-godot/ /path/to/your-godot-project/addons/Enable the plugin in Godot
Reopen your Godot project, go to Project → Project Settings → Plugins, and enable 'GDAI MCP'. A new 'GDAI MCP' tab will appear in the bottom panel. Start the local MCP server from that tab and note the generated JSON config.
Configure your MCP client
Add the GDAI MCP server to your AI client configuration using the absolute path to the Python server script inside your project's addons folder.
{
"mcpServers": {
"godot-mcp": {
"command": "uv",
"args": ["run", "/absolute/path/to/your-project/addons/gdai-mcp-plugin-godot/gdai_mcp_server.py"]
}
}
}Keep Godot open and start chatting
With your Godot project open and the MCP server running (visible in the GDAI MCP panel), open your AI client and start describing what you want to build or fix in your game project.
Godot AI Examples
Client configuration
Claude Desktop or Cursor MCP config block. Replace the path with the actual absolute path to your project's plugin script.
{
"mcpServers": {
"godot-mcp": {
"command": "uv",
"args": ["run", "/Users/you/my-game/addons/gdai-mcp-plugin-godot/gdai_mcp_server.py"]
}
}
}Prompts to try
Natural-language prompts for game development tasks in Godot.
- "Create a new 2D scene called Player with a CharacterBody2D root node and a Sprite2D child."
- "Read my main.gd script and fix any GDScript errors."
- "Search my project for all scenes that use a Camera2D node."
- "Add a CollisionShape2D to the Player node in the current scene."
- "Take a screenshot of the current Godot editor state and describe what's on screen."Troubleshooting Godot AI
MCP server fails to start with 'uv: command not found'
uv is not in PATH. Run the uv install script again and restart your terminal. Verify with 'uv --version'. On macOS, you may need to add ~/.cargo/bin or ~/.local/bin to your PATH.
AI client connects but tools return empty or stale data
The GDAI MCP plugin must be actively running in the Godot editor. Check the GDAI MCP tab at the bottom of Godot and click 'Start Server' if it's stopped. Also ensure the Godot project is fully loaded.
Plugin does not appear in Project Settings → Plugins
Confirm the addons folder was placed at the project root (res://addons/gdai-mcp-plugin-godot/). The folder name must match exactly. Restart the Godot editor after copying the files.
Frequently Asked Questions about Godot AI
What is Godot AI?
Godot AI is a Model Context Protocol (MCP) server that mcp server integration for godot engine that allows claude, cursor, windsurf, vscode, etc to perform actions like creating scenes, resources, scripts, reading errors and much more. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Godot AI?
Follow the installation instructions on the Godot AI GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Godot AI?
Godot AI works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Godot AI free to use?
Yes, Godot AI is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Godot AI Alternatives — Similar Coding Agents Servers
Looking for alternatives to Godot AI? Here are other popular coding agents servers you can use with Claude, Cursor, and VS Code.
Dify
★ 142.2kProduction-ready platform for agentic workflow development.
Ruflo
★ 54.0k🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integrat
Goose
★ 45.7kan open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
Antigravity Awesome Skills
★ 38.3kInstallable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
AgentScope
★ 25.5kBuild and run agents you can see, understand and trust.
Serena
★ 24.5kA coding agent toolkit that provides IDE-like semantic code retrieval and editing tools, enabling LLMs to efficiently navigate and modify codebases using symbol-level operations instead of basic file reading and string replacements.
Browse More Coding Agents MCP Servers
Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Godot AI in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Godot AI?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.