Godot MCP Bridge
The Godot MCP Bridge server enables AI assistants (Claude, Cursor, Copilot, etc.) to control and interact with the Godot 4 game editor through 168+ tools, allowing game development via natural language commands.
Connection Management
Connect/disconnect/check status of the WebSocket bridge to a running Godot editor
Send custom low-level commands via
godot_commandas an escape hatch
Project Management
Read/write project settings, browse filesystem trees, search files by pattern
Convert between UIDs and
res://paths, get autoload and metadata info
Scene Operations
Create, open, save, delete, play, and stop scenes
Get scene hierarchy (editor and runtime), instance scenes as child nodes
Node Manipulation
Add, delete, duplicate, rename, reparent, and update properties on nodes
Attach resources, set Control anchor presets, manage signals and groups
Full Undo/Redo support on all mutations
Script Management
List, read, create, edit, attach, and validate GDScript files
Search text across project files, list scripts open in the editor
Editor Interaction
Capture editor/game viewport screenshots, execute GDScript in editor or game context
Read error/output logs, clear console, reload plugins or the entire project
Input Simulation
Simulate keyboard events, mouse clicks/movement, and Godot Input actions
Run input sequences with delays, record and replay input sessions
List, create, and update input actions
Runtime Game Inspection & Modification
Read/set runtime node properties (single or batch), get the runtime scene tree
Execute scripts in game context, capture frames, monitor property values over time
Find UI elements, click buttons by text, wait for nodes to appear, navigate actors
Animation System
List, create, and remove animations in AnimationPlayer
Add tracks, set keyframes, get detailed animation info
TileMap Operations
Set, get, fill, and clear tile cells; get tilemap metadata and list used cells
Theme & UI Styling
Create theme resources, set color/constant/font size/StyleBox overrides
Performance & Profiling
Get real-time performance monitor values (FPS, memory, physics, rendering)
Get editor performance summaries and analyze scene complexity
Batch & Analysis
Find nodes by class type, script, or signal connections
Batch-get/set properties across multiple nodes, inspect all signals and connections
Key Features
Smart type parsing for Godot types (Vector2, Color, booleans, etc.)
Auto 2D/3D detection for physics, audio, and navigation nodes
Built-in presets for lighting, particles, shaders, and audio effects
JSON-RPC 2.0 over WebSocket bridge protocol
Provides 168 AI-powered tools for the Godot 4 Editor, enabling AI assistants to build games with natural language by creating scenes, editing scripts, simulating input, and analyzing running games.
Integrates with Godot 4.2+ editor via WebSocket bridge, providing 168 tools across 25 categories for scene manipulation, script editing, animation, physics, audio, and game testing through AI assistants.
Runs the TypeScript MCP server that bridges AI clients to the Godot editor plugin, handling communication between AI assistants and Godot's WebSocket server.
Supports SVG textures in Godot scenes through the update_property tool, allowing AI assistants to set SVG files as textures on nodes like Sprite2D.
Used to implement the MCP server that bridges AI clients to the Godot editor plugin, providing the tool definitions and WebSocket communication layer.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Godot MCP Bridgeadd a player node to the current scene"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Godot MCP Pro
168 AI-powered tools for the Godot 4 Editor β connect your AI assistant (Claude, Cursor, Cline, Copilot) to Godot and build games with natural language.
How It Works
Connect your AI assistant to Godot in under 5 minutes.
1. Install the Plugin
Copy addons/godot_mcp/ into your Godot project. Enable it in Project > Project Settings > Plugins. The plugin starts a WebSocket server inside the editor automatically.
2. Build the MCP Server
cd server
npm install && npm run buildThis compiles the TypeScript MCP server that bridges your AI client to the Godot plugin.
3. Start Building with AI
Add the server to your AI client's MCP config. Open Godot, and your AI assistant now has real-time access to 168 tools β creating scenes, editing scripts, simulating input, and analyzing your running game.
MCP Client Config
Claude Code / Claude Desktop
Add to .claude/mcp.json:
{
"mcpServers": {
"godot": {
"command": "node",
"args": ["/absolute/path/to/server/dist/index.js"]
}
}
}VS Code / Cursor
Add to .vscode/mcp.json:
{
"servers": {
"godot": {
"command": "node",
"args": ["./server/dist/index.js"]
}
}
}Any stdio MCP Client
node server/dist/index.jsThe server communicates over stdio (stdin/stdout) using the MCP protocol.
Automated Setup (recommended)
cd server
npm run runThis will automatically:
Build the MCP server
Detect
project.godotin parent folders (orGODOT_PROJECT_PATH)Sync addon to
addons/godot_mcpEnable plugin in
project.godotCreate MCP config files
Sync AI context files
Tool Categories
# | Category | Tools | Highlights |
1 | Project | 7 | Settings read/write, UID conversion |
2 | Scene | 9 | Create, open, play, stop, instance, save |
3 | Node | 14 | Add/delete/rename/move with UndoRedo, signals, groups |
4 | Script | 8 | CRUD, attach, validate, search with line numbers |
5 | Editor | 10 | Screenshots, execute GDScript, error log, reload |
6 | Input | 7 | Keyboard, mouse, action simulation, sequences |
7 | Runtime | 19 | Game inspection, frame capture, recording/replay, UI |
8 | Animation | 6 | CRUD, tracks, keyframes |
9 | AnimationTree | 8 | State machine, transitions, blend tree |
10 | TileMap | 6 | Cell operations (TileMapLayer for Godot 4.3+) |
11 | 3D Scene | 6 | Mesh primitives, .glb import, lighting presets, PBR |
12 | Physics | 6 | Auto 2D/3D collision, raycasts, layers |
13 | Particles | 5 | GPU particles + fire/smoke/rain/snow/sparks presets |
14 | Navigation | 6 | Region, agent, bake, pathfinding |
15 | Audio | 6 | Player (auto 2D/3D), bus effects chain |
16 | Theme/UI | 6 | StyleBoxFlat, color/constant/font overrides |
17 | Shader | 6 | Templates (canvas_item, spatial, particles, sky) |
18 | Resource | 6 | .tres CRUD, autoload management |
19 | Batch | 8 | Find by type, bulk set, dependency analysis |
20 | Testing | 6 | Automated scenarios, assertions, stress testing |
21 | Analysis | 4 | Scene complexity, signal flow, unused resources |
22 | Profiling | 2 | FPS, memory, physics, rendering monitors |
23 | Export | 3 | Preset listing, build commands |
Total | 168 | + 4 core connection tools |
Key Features
π§ Smart Type Parsing
No need to construct complex objects manually. Property values auto-convert:
"Vector2(100, 200)" β Vector2(100, 200)
"Color(1, 0, 0)" β Color(1, 0, 0)
"#ff0000" β Color(1, 0, 0)
"Color.RED" β Color(1, 0, 0)
"true" β true
"42" β 42β»οΈ Undo/Redo on All Mutations
Every add_node, delete_node, update_property, rename_node, and move_node goes through Godot's UndoRedo system. Your users can Ctrl+Z any AI action.
π― Auto 2D/3D Detection
Physics bodies, collision shapes, audio players, particles, and navigation nodes automatically detect whether the parent is 2D or 3D β the right type is created every time.
π₯ Built-in Presets
Lighting: sun, indoor, dramatic, spot
Particles: fire, smoke, rain, snow, sparks
Shaders: canvas_item, spatial, particles, sky templates
Audio effects: reverb, delay, compressor, EQ, distortion, chorus, phaser
Quick Example
AI: godot_connect
AI: create_scene path="res://scenes/level.tscn" rootType="Node2D"
AI: add_node type="CharacterBody2D" name="Player" parentPath="."
AI: add_node type="Sprite2D" name="Sprite" parentPath="Player"
AI: update_property path="Player/Sprite" property="texture" value="res://icon.svg"
AI: setup_collision path="Player" shapeType="rectangle" size="Vector2(32, 32)"
AI: create_script path="res://scripts/player.gd" content="extends CharacterBody2D..."
AI: attach_script nodePath="Player" scriptPath="res://scripts/player.gd"
AI: save_scene
AI: play_scene
AI: simulate_key key="Space"
AI: get_game_screenshot
AI: stop_sceneArchitecture
server/src/
βββ index.ts TypeScript MCP server (stdio transport)
βββ toolCatalog.ts 168 tool definitions with input schemas
βββ godotBridge.ts WebSocket client β Godot editor
addons/godot_mcp/
βββ plugin.gd Plugin entry point
βββ websocket_server.gd Local WebSocket server (port 6505)
βββ command_router.gd Loads 20 handler modules, dispatches commands
βββ commands/
βββ base_commands.gd Shared utilities (type parser, undo, I/O)
βββ type_parser.gd Smart stringβGodot type conversion
βββ undo_helper.gd UndoRedo wrapper
βββ core_commands.gd Project, scene, node, script, editor (47 handlers)
βββ editor_commands.gd Screenshots, execute script (4)
βββ input_commands.gd Input simulation (7)
βββ runtime_commands.gd Game inspection & UI (15)
βββ animation_commands.gd Animation CRUD (6)
βββ animation_tree_commands.gd State machine & blend tree (8)
βββ tilemap_commands.gd Tile operations (6)
βββ scene3d_commands.gd 3D scene building (6)
βββ physics_commands.gd Physics & collision (6)
βββ particles_commands.gd GPU particles + presets (5)
βββ navigation_commands.gd Nav regions & pathfinding (6)
βββ audio_commands.gd Audio players & bus effects (6)
βββ theme_commands.gd Theme & UI styling (6)
βββ shader_commands.gd Shader management (4)
βββ resource_commands.gd Resource & autoload (6)
βββ batch_commands.gd Batch operations (8)
βββ testing_commands.gd Testing & QA (5)
βββ analysis_commands.gd Code analysis (4)
βββ profiling_commands.gd Performance profiling (2)
βββ export_commands.gd Export management (3)Bridge Protocol
JSON-RPC 2.0 over WebSocket (ws://127.0.0.1:6505):
β { "jsonrpc": "2.0", "id": 1, "method": "add_node", "params": { "type": "Sprite2D", "name": "Player" } }
β { "jsonrpc": "2.0", "id": 1, "result": { "tool": "add_node", "data": { "path": "/root/Main/Player" } } }Override bridge URL: GODOT_WS_URL=ws://127.0.0.1:6505 node server/dist/index.js
Requirements
Godot 4.2+ (4.3+ recommended for TileMapLayer)
Node.js 18+
Any MCP-compatible AI client
AI Agent Context Files
When deployed to a Godot project, these context files help AI assistants understand the available tools:
File | Purpose | Used by |
| Complete 168-tool reference with workflows | All AI agents |
| Architecture + capability summary | Codex, Gemini, agents |
| Quick reference + build commands | Claude Code |
| Copilot-specific instructions | GitHub Copilot |
References
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Farraskuy/Godot-MCP'
If you have feedback or need assistance with the MCP directory API, please join our Discord server