Best for
- AI agents working with the Godot engine for development assistance
- Developers who want to automate project launching and debug feedback loops
- AI tools that need to dynamically create and modify scenes in Godot projects
G
Godot MCP Server
Community
MCP server for interfacing with the Godot game engine
GitHub source repository ↗
61FMRS · C
This server provides a bridge for AI agents to interact with the Godot engine, supporting editor launching, project running, debug output capture, and more. Its GDScript integration allows complex scene operations, making it suitable for AI-assisted game development. Installation is straightforward and compatible with multiple MCP clients.
The Godot MCP server enables AI agents to launch the Godot editor, run projects, capture debug output, and control project execution. It provides a direct feedback loop that helps agents understand what works and what doesn't in real Godot projects, leading to better code generation and debugging assistance. The server uses a bundled GDScript script to handle complex operations such as creating scenes, adding nodes, loading sprites, and exporting MeshLibrary resources.
Tools
launch_editor
Launch the Godot editor for a specific project.
run_project
Run a Godot project in debug mode.
get_debug_output
Retrieve console output and error messages.
stop_project
Stop a running Godot project programmatically.
get_godot_version
Retrieve the installed Godot version.
list_projects
Find Godot projects in a specified directory.
get_project_info
Get detailed information about the project structure.
create_scene
Create a new scene with a specified root node type.
add_node
Add nodes to an existing scene with customizable properties.
load_sprite
Load sprites and textures into Sprite2D nodes.
export_mesh_library
Export 3D scenes as MeshLibrary resources for GridMap.
save_scene
Save scenes with options for creating variants.
get_uid
Get the UID for a specific file (Godot 4.4+).
update_project_uids
Update UID references by resaving resources (Godot 4.4+).
Setup
- Ensure the Godot Engine is installed on your system.\n2. Ensure Node.js (>=18.0.0) and npm are installed.\n3. For Claude Code, run:
claude mcp add godot -- npx @coding-solo/godot-mcp.\n4. For Cline, add the provided configuration to the Cline MCP settings file.\n5. For Cursor, add the server via the UI or a project-specific mcp.json.\n6. Optionally, set environment variables GODOT_PATH and DEBUG before running.
claude_desktop_config.json
{
"mcpServers": {
"godot": {
"command": "npx",
"args": [
"@coding-solo/godot-mcp"
],
"env": {
"GODOT_PATH": "/path/to/godot",
"DEBUG": "true"
}
}
}
}
Fit and risk
Not for
- Developers not using the Godot engine
- Users requiring remote or HTTP-based connections (only stdio transport)
- Users without a need for Godot 4.4+ UID features
Required permissions
- Execute the Godot executable (to launch editor, run projects)
- Read specified project directories to list projects and get information
- Write files in the project directory to create scenes, add nodes, and save scenes
- Read console output to capture debug information
Risks and side effects
- Running untrusted Godot projects may execute arbitrary code, posing security risks
- Automatic modification of project files may lead to unintended changes; version control is recommended
- Operations may fail if the Godot version or path is configured incorrectly
- High volumes of operations may consume system resources, affecting performance
Troubleshooting
- If Godot is not found, set the environment variable `GODOT_PATH` to your Godot executable path.
- If connection issues occur, ensure the server is running and restart your AI assistant.
- If the project path is invalid, ensure the path points to a directory containing a `project.godot` file.
- If build issues arise, run `npm install` to install all dependencies.
- For Cursor users, ensure the MCP server is enabled in settings and use the Agent chat profile (requires Cursor Pro or Business subscription).
Use cases
AI-assisted development and debugging of Godot projects
Automated scene creation and node manipulation
Real-time capture of game run output during coding sessions
Batch management of projects and scene resources
Supported clients
Claude DesktopFull support
ClineFull support
CursorFull support