godot-mcp
Click on "Deploy 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 Create a Godot 4 project called shooter with a player script and validate it."
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
An MCP server that lets an AI assistant create and validate Godot 4 games. It writes real project files (project.godot, .tscn scenes, .gd scripts), then runs Godot headless to check them.
Requirements
Node.js 18 or newer
Godot 4.x on your
PATH(or setGODOT_PATH). Tested with Godot 4.6.3.
Related MCP server: godot-mcp
Install
git clone https://github.com/C0wRat/godot-mcp.git
cd godot-mcp
npm install
npm run buildConnect to Claude Code
claude mcp add godot \
-e GODOT_PROJECTS_DIR="$HOME/godot-projects" \
-- node /absolute/path/to/godot-mcp/dist/server.jsOr add it to a project's .mcp.json:
{
"mcpServers": {
"godot": {
"command": "node",
"args": ["/absolute/path/to/godot-mcp/dist/server.js"],
"env": { "GODOT_PROJECTS_DIR": "/home/you/godot-projects" }
}
}
}Configuration
Variable | Default | Purpose |
|
| Folder that holds every project. All writes stay inside it. |
|
| Godot executable. |
Tools
Tool | What it does |
| Creates a project folder with |
| Creates a |
| Adds a node to a scene. Optional |
| Creates a |
| Sets the scene that runs on start. |
| Checks every script for parse errors and runs the project headless. Returns |
Paths are relative to the project. Absolute paths and paths that escape the project folder are rejected.
Example session
An assistant with this server can build a small game like this:
create_projectwithname: "shooter"create_scriptforscripts/player.gd, extendingCharacterBody2Dadd_nodeforPlayerwithscript_path: "scripts/player.gd"add_nodeforCollisionShape2Dunderparent: "Player"validate_project, which must returnok: truebefore the game is considered working
Limitations
The server creates and edits files. It does not open the Godot editor or play the game in a window.
It cannot read or change existing scripts or nodes, and it does not remove nodes.
create_scriptrefuses to overwrite a file.Node and class names are checked as identifiers. Whether a class exists is only known when
validate_projectruns.Property values are passed through as Godot literals and are not type-checked until validation.
Development
npm testnpm test builds the project, then runs unit tests for the file logic and an end-to-end test. The end-to-end test starts the server over MCP stdio and builds a small game. Both need Godot on PATH or GODOT_PATH.
License
MIT
Available Tools
6 toolsadd_nodeA
Add a node to an existing scene. Property values are Godot literal expressions, e.g. position: "Vector2(10, 20)", text: '"Hello"'. A script_path attaches a script to the node.
Inputs: name (required), type (required), project (required), scene_path (required), +3 more.
create_projectB
Create a Godot 4 project with a scenes/ and scripts/ folder and a main scene (scenes/main.tscn, Node2D root). Creates the project under the projects directory.
Inputs: name (required), display_name.
create_sceneB
Create a new .tscn scene with a single root node.
Inputs: project (required), root_name (required), root_type (required), scene_path (required).
create_scriptA
Create a GDScript file. Without content, writes a template with the given extends type and an empty _ready().
Inputs: project (required), script_path (required), content, extends.
set_main_sceneC
Set the scene that runs when the game starts.
Inputs: project (required), scene_path (required).
validate_projectA
Check every script for parse errors and run the project headless to catch scene and load errors. Returns ok: true only when Godot reports no errors.
Inputs: project (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a distinct object (project, scene, node, script) or a distinct action (set main scene, validate), so misselection is unlikely. The only mild overlap is between create_project (which auto-creates a main scene) and set_main_scene, but the descriptions make the boundary clear.
All six tools follow a consistent snake_case verb_noun pattern (create_project, create_scene, add_node, create_script, set_main_scene, validate_project). No mixed conventions or vague verbs.
Six tools is a well-scoped set for Godot project scaffolding: each tool covers a distinct lifecycle step (project, scene, node, script, main scene, validation). Nothing feels redundant or missing at the count level.
Creation is well covered, but the surface is write-only: there is no way to read/list existing scenes or scripts, remove nodes/scenes/scripts, or edit an existing script's content. An agent cannot inspect project state, which will cause dead ends in any non-trivial workflow.
Maintenance
Related MCP Connectors
Build, validate, test-run and publish AIOS workflows from Claude Code, Codex, Cursor or VS Code.
Turn an idea or meeting transcript into a working single-file AI agent, check it, use it right away.
Turn an idea or meeting transcript into a working single-file AI agent, check it, use it right away.
Turn an idea or meeting transcript into a working single-file AI agent, check it, use it right away.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents to create, edit, and run Godot 4.5+ games by providing tools for project scaffolding, scene manipulation, and engine interaction. It supports full game development workflows including node editing, script attachment, and project execution with debugging capabilities.245MIT
- AlicenseBqualityCmaintenanceEnables AI assistants to interact with the Godot game engine, including launching the editor, running projects, capturing debug output, and managing scenes.8470 PyPI1MIT
- AlicenseCqualityDmaintenanceEnables AI assistants to interact with and manipulate Godot game engine projects, including creating projects, launching editor, managing scenes and nodes.121ISC
- AlicenseBqualityDmaintenanceEnables AI-assisted Godot 4.x game development within a secure sandbox, covering project management, file operations, asset discovery, GDScript generation, and optional runtime execution.4051 PyPI2MIT