Godot MCP

What is Godot MCP?

Godot MCP is a Model Context Protocol server that bridges AI assistants (such as Claude, Cursor, and Cline) with the Godot game engine, enabling them to launch editors, run projects, manage scenes, and capture debug output through a standardized interface.

How to use Godot MCP?

Install by cloning the repository, running npm install and npm run build. Configure the server by adding a JSON entry (with command, args, and environment variables) to your AI assistant’s MCP settings file (e.g., for Cline, Cursor, or VS Code). Optionally set GODOT_PATH, DEBUG, or READ_ONLY_MODE environment variables.

Key features of Godot MCP

• Launch Godot editor and run projects with debug output capture
• Create, modify, and manage Godot scenes and nodes
• Load textures into Sprite2D nodes and export MeshLibrary resources
• Get Godot version, project info, and list projects in directories
• Support for Godot 4.4+ UID management (get and update UIDs)
• Optional read-only mode for safe project analysis
• Zero-config automatic Godot detection with manual override

Use cases of Godot MCP

• AI-assisted scene creation and node editing in Godot projects
• Automated testing and debugging of Godot games using natural language
• Project analysis and refactoring with real-time Godot output feedback
• Managing multiple Godot projects and their UIDs programmatically

FAQ from Godot MCP

Which Godot versions are supported?

Godot 3.5+ or 4.0+ (latest stable recommended).

Can I use Godot MCP with Cursor or VS Code?

Yes. Cursor supports both UI-based configuration and a project-specific .cursor/mcp.json file; VS Code also works via MCP settings.

Is there a read-only mode for safety?

Yes. Set the environment variable READ_ONLY_MODE to true to restrict operations to analysis only.

What AI assistants are compatible?

Cline & Roo Code (full support), Cursor & VS Code, Claude Desktop, and any tool supporting the Model Context Protocol.

How do I specify the Godot executable path?

Set the GODOT_PATH environment variable (e.g., /usr/bin/godot4). If not set, the server auto-detects the Godot installation.