Godot MCP Pro
84 AI-powered tools connecting Claude, Cursor, and other AI assistants directly to your Godot editor.
Architecture
AI Assistant <--stdio/MCP--> Node.js Server <--WebSocket:6505--> Godot Editor Plugin
Real-time bidirectional communication. No file polling. No CLI subprocess spawning.
84 Tools across 14 Categories
| Category | Tools | Highlights |
|---|---|---|
| Project | 7 | Read/write project settings, file search, UID conversion |
| Scene | 9 | Live scene tree, create/open/delete, play/stop, instancing |
| Node | 11 | Add/delete/rename/duplicate/move, properties, signals, anchors |
| Script | 6 | List/read/create/edit scripts, attach to nodes |
| Editor | 8 | Screenshots, GDScript execution, error log, signals inspector |
| Input Simulation | 5 | Keyboard, mouse, InputAction, multi-event sequences |
| Runtime Analysis | 4 | Game scene tree, runtime properties, frame capture, property monitor |
| Animation | 6 | Create animations, add tracks, insert keyframes programmatically |
| TileMap | 6 | Set/fill/query cells, tile set info, bulk operations |
| Theme & UI | 6 | Colors, constants, font sizes, StyleBoxFlat, theme inspector |
| Shader | 6 | Create/edit shaders, assign materials, set/get uniforms |
| Batch & Refactoring | 5 | Find by type, signal audit, batch property set, dependency analysis |
| Profiling | 2 | FPS, memory, draw calls, physics monitors |
| Export | 3 | List presets, export commands, template info |
Key Features
- Full Undo/Redo - All mutations go through Godot's UndoRedo system
- Smart Type Parsing -
"Vector2(100,200)","#ff0000","Color(1,0,0)"auto-converted - Auto-Reconnect - Exponential backoff (1s -> 60s max)
- Heartbeat - 10s ping/pong keeps connection alive
- Contextual Errors - Structured error codes with actionable suggestions
- Port Auto-Scan - Tries ports 6505-6509, no configuration needed
Comparison
| Godot MCP Pro | Best Free Alternative | |
|---|---|---|
| Total Tools | 84 | 32 |
| Undo/Redo | Yes | No |
| Signal Management | Yes | No |
| Input Simulation | Key/Mouse/Action/Sequence | No |
| Runtime Inspection | Scene tree + Properties + Frames | No |
| Animation Tools | Yes | No |
| TileMap Tools | Yes | No |
| Shader Tools | Yes | No |
| Profiling | Yes | No |
Requirements
- Godot 4.4+ (tested on 4.6)
- Node.js 18+
- Any MCP-compatible AI client (Claude Code, Claude Desktop, Cursor, VS Code + Cline, etc.)
Installation
- Download from Buy Me a Coffee ($5 one-time, lifetime updates for v1.x)
- Copy
addons/godot_mcp/into your Godot project - Enable the plugin: Project > Project Settings > Plugins > Godot MCP Pro
- Install the MCP server:
cd server npm install npm run build - Configure your AI client's
.mcp.json:{ "mcpServers": { "godot-mcp-pro": { "command": "node", "args": ["/path/to/server/build/index.js"] } } } - Use it - Open Godot with the plugin enabled, then interact via your AI assistant
Links
License
Proprietary. One-time purchase includes lifetime updates for v1.x. Unlimited projects and machines.