Better Godot MCP
Better Godot MCP is a composite MCP server providing 17 mega-tools for AI-assisted Godot 4 game development, enabling full project management, scene/node manipulation, scripting, and more — without requiring Godot to be running.
Project Management: Get project info/version, run/stop the game, read/write project settings, and export using defined presets
Scene Management: Create, list, inspect, delete, duplicate, and set the main scene for
.tscnfilesNode Manipulation: Add, remove, rename, and list nodes in a scene tree; get and set node properties
GDScript CRUD: Create, read, write, attach, list, and delete GDScript files
Editor Control: Launch the Godot editor and check its status
Environment & Configuration: Auto-detect the Godot binary, verify the environment, and view/set server configuration options
Resource Management: List, inspect, delete, and configure import settings for resource files (images, audio, fonts, shaders, etc.)
Input Map: List, add, and remove input actions and events (keyboard, mouse, joypad)
Signal Connections: List, connect, and disconnect signals between nodes in a scene
Animation: Create AnimationPlayer nodes, add animations, tracks (value, method, bezier), and keyframes
TileMap & TileSet: Create TileSets, add texture sources, set/paint tiles, and list TileMaps
Shader Management: Create, read, write, and inspect parameters of Godot 4
.gdshaderfilesPhysics Configuration: View/set collision layers, configure physics body properties (mass, gravity scale), and name 2D/3D physics layers
Audio Management: List audio buses, add buses and effects, and create AudioStreamPlayer nodes (2D, 3D, or global)
Navigation: Create navigation regions, add agents and obstacles for 2D/3D pathfinding
UI Controls & Themes: Create UI Control nodes, apply themes, set layout presets, and list controls in a scene
Help: Retrieve full documentation for any tool on demand
Enables AI agents to manage Godot Engine projects through a suite of composite tools for scene manipulation (.tscn), GDScript and shader editing, node property configuration, input mapping, and project export operations.
Better Godot MCP
mcp-name: io.github.n24q02m/better-godot-mcp
Composite MCP server for Godot Engine -- 17 mega-tools for AI-assisted game development
Features
17 composite mega-tools -- scene, node, script, shader, animation, tilemap, physics, audio, navigation, UI, and more
Full scene control -- create, parse, and modify
.tscnfiles directly without Godot runningGDScript CRUD -- create, read, write, and attach scripts in a single call
Tiered token optimization -- compressed descriptions + on-demand
helptool
Related MCP server: WET - Web Extended Toolkit
Setup
With AI Agent -- copy and send this to your AI agent:
Please set up @n24q02m/better-godot-mcp for me. Follow this guide: https://raw.githubusercontent.com/n24q02m/better-godot-mcp/main/docs/setup-with-agent.md
Manual Setup -- follow docs/setup-manual.md
Tools
Tool | Actions | Description |
|
| Project metadata, run/stop, and settings |
|
| Scene file management |
|
| Scene tree node manipulation |
|
| GDScript file CRUD |
|
| Launch Godot editor and check status |
|
| Server configuration and environment detection |
|
| Resource file management |
|
| Input action and event mapping |
|
| Signal connections |
|
| Animation players and tracks |
|
| TileMap and TileSet management |
|
| Shader file CRUD with Godot 4 syntax |
|
| Collision layers and physics bodies |
|
| Audio bus and effect management |
|
| Navigation regions, agents, and obstacles |
|
| UI control creation and theming |
| - | Get full documentation for any tool |
Configuration
Godot binary is auto-detected from common install locations and PATH. No environment variables are required for basic usage. Optionally set GODOT_PROJECT_PATH and GODOT_PATH to override defaults.
Variable | Required | Default | Description |
| No | - | Default project path (tools also accept |
| No | Auto-detected | Path to Godot binary |
Limitations
Requires Godot 4.x project structure
Scene files (
.tscn) are parsed/modified via text manipulation, not Godot's internal APIrun/stop/exportactions require Godot binary to be installedDocker mode has limited filesystem access (mount your project directory)
Security
Binary detection -- Multi-path Godot detection (env, PATH, common locations)
Project validation -- Verifies project.godot exists before operations
Cross-platform -- Windows, macOS, Linux path handling
Build from Source
git clone https://github.com/n24q02m/better-godot-mcp.git
cd better-godot-mcp
bun install
bun run devLicense
MIT -- See LICENSE.
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/n24q02m/better-godot-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server