godot-mcp
Godot MCP is a Node.js/TypeScript server that enables AI agents (Claude, Cline, Cursor) to launch and control the Godot game engine, run projects, capture debug output, and manipulate scenes programmatically. It bridges AI development workflows with Godot game development by providing direct editor and project execution control.
Key facts
Objective fields from the source. Values we can't verify are shown as “Unknown” rather than guessed.
| Field | Value |
|---|---|
| Repository | Coding-Solo/godot-mcp |
| Owner | Coding-Solo |
| Primary language | JavaScript |
| License | MIT — OSI-approved |
| Stars | 4.6k |
| Forks | 424 |
| Open issues | 57 |
| Latest release | Unknown |
| Last updated | 2026-04-16 |
| Source | https://github.com/Coding-Solo/godot-mcp |
What godot-mcp is
An MCP (Model Context Protocol) server written in JavaScript/TypeScript that wraps Godot CLI commands and executes bundled GDScript operations via a single `godot_operations.gd` file. Supports scene creation, node management, sprite loading, mesh export, and UID management (Godot 4.4+) by communicating with the Godot executable.
Get the godot-mcp source
Clone the repository and explore it locally.
git clone https://github.com/Coding-Solo/godot-mcp.gitcd godot-mcp# follow the project's README for install & configurationNeed it deployed, integrated, or customized instead? DEV.co ships production installs.
Best use cases
Implementation considerations
- Godot Engine must be installed locally; set GODOT_PATH environment variable if auto-detection fails.
- Requires Node.js >= 18.0.0 and npm for installation and execution.
- MCP client (Claude Code, Cline, Cursor Pro) must support MCP servers; configuration differs by tool.
- GDScript bundled operations are version-dependent; Godot 4.4+ required for UID management features.
- No authentication, access control, or sandboxing mentioned; restrict to trusted AI agents and local development environments only.
When to avoid it — and what to weigh
- Production Game Builds — This server is designed for development and AI-assisted workflows, not for packaging or releasing commercial game binaries. Use Godot's native export pipeline for production.
- Multi-User Collaborative Workflows — No mention of version control integration, conflict resolution, or support for multiple agents/users accessing the same project simultaneously. Not suitable for team-based concurrent development.
- Large or Complex Project Operations — Operations rely on CLI calls and a single bundled GDScript; performance and reliability at scale (large scenes, many nodes, heavy asset libraries) is Unknown. No benchmarks or stress-test data provided.
- Headless/Server Deployment — Requires Godot Engine installed on the system and assumes GUI interaction. Not designed for containerized, headless, or cloud-only workflows without X11/display support.
License & commercial use
Licensed under MIT (https://opensource.org/licenses/MIT), a permissive OSI-approved license allowing unrestricted use, modification, and distribution with attribution.
MIT license explicitly permits commercial use without restriction. However, this server itself is a development tool; any commercial game built with Godot and assisted by this MCP server is subject to Godot's own licensing (permissive), not this project's license. Verify Godot engine licensing for your use case.
DEV.co evaluation signals
Editorial assessment — not user reviews. Directional, with an explicit confidence level.
| Signal | Assessment |
|---|---|
| Maintenance | Active |
| Documentation | Adequate |
| License clarity | Clear |
| Deployment complexity | Low |
| DEV.co fit | Good |
| Assessment confidence | High |
Executes GDScript and CLI commands via the Godot executable; restrict server access to trusted AI agents and local development machines. No input validation, sanitization, or execution sandboxing documented. DEBUG mode may expose sensitive paths. Ensure GODOT_PATH points to a secure, verified executable. Not suitable for untrusted or remote agent environments.
Alternatives to consider
Godot GDScript Language Server (LSP) + native REST API
Provides syntax checking and basic completion without full project execution. Lighter-weight but lacks real-time debug output capture and scene manipulation.
Unreal Engine MCP or other game engine integrations
If targeting C++ or Blueprint-based development instead of GDScript; Unreal offers more mature production workflows but higher complexity.
Custom Python/CLI wrapper around Godot headless execution
More control over execution environment and logging, but requires custom development and lacks pre-built MCP integration for Claude/Cline/Cursor.
Build on godot-mcp with DEV.co software developers
Start using Godot MCP with Claude Code, Cline, or Cursor today. Install via npx, configure your MCP client, and let AI assist your game development workflow.
Talk to DEV.coRelated open-source tools
Surfaced by semantic similarity across the DEV.co open-source index.
Related on DEV.co
Explore the category and the services that help you build with it.
godot-mcp FAQ
Can I use this on Windows, macOS, and Linux?
Does this server support Godot 3.x?
Can AI agents modify the same project concurrently?
Is there a web-based or cloud-hosted version?
Work with a software development agency
DEV.co is a software development agency delivering custom software development services to companies building on open source. Our software developers and web developers design, integrate, and ship production systems — spanning web development, APIs, AI, data, and cloud. If godot-mcp is part of your mcp servers roadmap, our team can implement, customize, migrate, and maintain it.
Ready to Integrate AI with Godot?
Start using Godot MCP with Claude Code, Cline, or Cursor today. Install via npx, configure your MCP client, and let AI assist your game development workflow.