Godot MCP
An MCP server that enables AI agents to interact with the Godot game engine by launching the editor, running projects, capturing debug output, and managing scenes and resources. It provides tools for project analysis, scene creation, and execution co
What is Godot MCP?
Godot MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server that enables ai agents to interact with the godot game engine by launching the editor, running projects, capturing debug output, and managing scenes and resources. it provides tools for pro...
An MCP server that enables AI agents to interact with the Godot game engine by launching the editor, running projects, capturing debug output, and managing scenes and resources. It provides tools for project analysis, scene creation, and execution co
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- An MCP server that enables AI agents to interact with the Go
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @coding-solo/godot-mcpManual Installation
npx -y @coding-solo/godot-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Godot MCP
Godot MCP is a Model Context Protocol server that bridges AI agents directly to the Godot game engine, enabling programmatic control of the editor, project execution, and scene management. It lets you launch the Godot editor, run projects in debug mode, capture console output, create scenes with nodes, load sprites, and manage resource UIDs — all from your AI client. Developers use it to accelerate game prototyping and get AI assistance that understands and can act on the actual state of their Godot projects.
Prerequisites
- Node.js 18+ and npm installed (for npx execution)
- Godot 4.x installed on your system (Godot 4.4+ recommended for UID management features)
- An MCP client such as Claude Desktop or Claude Code
- A Godot project directory accessible on disk
Install the MCP server via npx
The server runs via npx without a global install. Add it to your MCP client configuration using the package @coding-solo/godot-mcp.
npx -y @coding-solo/godot-mcpLocate your Godot executable path
Find where the Godot binary is installed. On macOS this is typically inside the .app bundle; on Linux it may be in /usr/bin/godot or a custom path. You will set this as the GODOT_PATH environment variable.
which godot
# macOS example: /Applications/Godot.app/Contents/MacOS/Godot
# Linux example: /usr/bin/godot4Configure your MCP client
Add the server configuration to your Claude Desktop config file at ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows). Set GODOT_PATH to your Godot executable. Optionally set DEBUG to true for detailed logging.
{
"mcpServers": {
"godot": {
"command": "npx",
"args": ["-y", "@coding-solo/godot-mcp"],
"env": {
"GODOT_PATH": "/Applications/Godot.app/Contents/MacOS/Godot",
"DEBUG": "false"
}
}
}
}Restart your MCP client
Restart Claude Desktop or your chosen MCP client to load the new server configuration. The Godot MCP tools will appear in the tool list once the server starts successfully.
Point the server at a Godot project
Open a Godot project directory in your file system. When prompting the AI, reference the project path so the server can discover and interact with the correct project.godot file.
Verify the connection
Ask your AI client to list Godot projects in a directory or retrieve the installed Godot version to confirm the server is connected and the Godot executable is accessible.
Godot MCP Examples
Client configuration
Claude Desktop config with Godot executable path and optional debug logging.
{
"mcpServers": {
"godot": {
"command": "npx",
"args": ["-y", "@coding-solo/godot-mcp"],
"env": {
"GODOT_PATH": "/Applications/Godot.app/Contents/MacOS/Godot",
"DEBUG": "false"
}
}
}
}Prompts to try
Example prompts that exercise the real tools this server exposes.
- "List all Godot projects in /Users/me/gamedev and show me the structure of the main one"
- "Create a new 2D scene called Player with a CharacterBody2D root node and a Sprite2D child"
- "Load the texture res://assets/player.png into the Sprite2D node in the Player scene"
- "Run the project at /Users/me/gamedev/my-game and capture the debug output"
- "Export the 3D level scene as a MeshLibrary resource for use with GridMap"
- "What version of Godot is installed and what Godot projects exist in the current directory?"Troubleshooting Godot MCP
Server fails to start with 'Godot executable not found'
Set the GODOT_PATH environment variable explicitly in your config to the full path of your Godot binary. On macOS this is often /Applications/Godot.app/Contents/MacOS/Godot. Run 'which godot' or 'which godot4' to find the path on Linux.
Editor launches but project does not open correctly
Ensure the path you provide points to a directory containing a project.godot file. The server discovers projects by looking for this file, so nested or non-standard project layouts may require specifying the exact project directory.
UID management tools are unavailable
UID-related tools (get file UIDs, update UID references) require Godot 4.4 or newer. Update your Godot installation to 4.4+ and ensure GODOT_PATH points to the updated binary.
Frequently Asked Questions about Godot MCP
What is Godot MCP?
Godot MCP is a Model Context Protocol (MCP) server that mcp server that enables ai agents to interact with the godot game engine by launching the editor, running projects, capturing debug output, and managing scenes and resources. it provides tools for project analysis, scene creation, and execution co It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Godot MCP?
Install via npm with the command: npx -y @coding-solo/godot-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Godot MCP?
Godot MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Godot MCP free to use?
Yes, Godot MCP is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Godot MCP Alternatives — Similar Developer Tools Servers
Looking for alternatives to Godot MCP? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Godot MCP 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 MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.