What can you do with this server?

Better Godot MCP is a local, credential-free MCP server exposing 17 composite tools for AI-assisted Godot 4.x game development, letting an AI agent read and write your project files directly. * Project: read metadata, check engine version, run/stop the game, view run logs, get/set project settings, export builds * Scenes: create, list, inspect, delete, duplicate .tscn files, and set the main scene * Nodes: add, remove, rename, list, and get/set properties on scene tree nodes * Scripts: create, read, write, attach, list, and delete GDScript files * Editor: launch the Godot editor and check its status * Config: view server config, update settings, detect the Godot binary, and verify project/environment availability * Resources: list, inspect, delete resource files, and view import settings * Input map: list, add, and remove input actions and add key/mouse/joypad events * Signals: list, connect, and disconnect signal connections in scenes * Animation: create AnimationPlayers, add animations, tracks, and keyframes * TileMap: create TileSets, add sources, set tiles, and paint tiles * Shader: create, read, write, list .gdshader files and get shader parameters * Physics: manage collision layers, collision setup, body config, and layer names * Audio: list/add audio buses, add effects, and create stream players * Navigation: create navigation regions and add agents and obstacles * UI: create Control nodes, set themes, apply layouts, and list controls * Help: fetch full documentation for any tool to save tokens * Transport/ops: stdio by default or Streamable HTTP (--http), plus detect and doctor CLI diagnostics; runs via npx or Docker (amd64/arm64)

Which integrations are available for this server?

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.

de en es ja ko ru zh

Better Godot MCP

by n24q02m

Overview Schema Source Related Servers Discussions Admin

TypeScript

ARCHIVED 2026-09-13 — This repository is no longer maintained. Use the Godot editor + GDScript CLI toolchain instead of this MCP server. Existing installations keep working but receive no updates or support.

Better Godot MCP

mcp-name: io.github.n24q02m/better-godot-mcp

Composite MCP server for Godot Engine -- 17 composite tools for AI-assisted game development.

Project	Tagline	Tag
agent-chat-plugin	Peer AI agents chat in a shared folder — no human relay, no orchestrator, wor...	Tooling
better-code-review-graph	Knowledge graph for token-efficient code reviews -- semantic search and call-...	MCP
better-drive	2-way Google Drive sync with .driveignore filter — rclone engine, Windows tray	Tooling
better-email-mcp	IMAP/SMTP email for AI agents -- read, send, organize folders, and manage att...	MCP
better-godot-mcp	Composite MCP server for Godot Engine -- 17 composite tools for AI-assisted g...	MCP
better-notion-mcp	Markdown-first Notion for AI agents -- pages, databases, blocks, and comments...	MCP
better-semantic-release	Drop-in python-semantic-release fork with built-in release-safety guards (orp...	Tooling
better-telegram-mcp	Telegram for AI agents -- messages, chats, media, and contacts across both bo...	MCP
better-workspace-mcp	Google Workspace MCP server (Docs/Drive/Calendar/Gmail/Sheets/Slides/Tasks/Ch...	MCP
claude-plugins	Claude Code plugin marketplace for the n24q02m MCP servers -- install web sea...	Marketplace
imagine-mcp	Image and video understanding + generation for AI agents -- across Gemini, Op...	MCP
jules-task-archiver	Chrome Extension for bulk operations on Jules tasks via batchexecute API -- a...	Tooling
mcp-core	Shared foundation for building MCP servers -- Streamable HTTP transport, OAut...	MCP
mnemo-mcp	Persistent AI memory with hybrid search and embedded sync. Open, free, unlimi...	MCP
qwen3-embed	Lightweight Qwen3 text embedding and reranking via ONNX Runtime and GGUF	Library
skret	Secrets without the server.	CLI
tacet	A self-distilling neuro-symbolic cascade that amortises LLM cost across knowl...	Tooling
web-core	Shared web infrastructure package for search, scraping, HTTP security, and st...	Library
wet-mcp	Open-source MCP server for AI agents: web search, content extraction, and lib...	MCP

Related MCP server: Godot MCP Unified

Features

17 composite mega-tools -- scene, node, script, shader, animation, tilemap, physics, audio, navigation, UI, and more
Full scene control -- create, parse, and modify .tscn files directly without Godot running
GDScript CRUD -- create, read, write, and attach scripts in a single call
Tiered token optimization -- compressed descriptions + on-demand help tool

Install

Runs over stdio by default. No credentials, no account, no relay -- the server reads and writes your local Godot project files directly. Godot 4.x is optional for file operations; only run/stop/export and editor actions need a Godot binary. The detector accepts Godot >=4.1. Live engine compatibility is currently verified with Godot 4.7.1 stable; this does not claim that every future minor release has been verified.

Via npx (recommended)

npx -y @n24q02m/better-godot-mcp@latest

MCP client config

Add to your client's MCP config (Claude Code, Cursor, Windsurf, Codex, mcp.json):

{
  "mcpServers": {
    "better-godot-mcp": {
      "command": "npx",
      "args": ["-y", "@n24q02m/better-godot-mcp"],
      "env": {
        "GODOT_PROJECT_PATH": "/path/to/your/godot/project"
      }
    }
  }
}

GODOT_PROJECT_PATH is optional -- every tool also accepts a project_path argument per call.

Via Docker

docker run -i --rm -v /path/to/your/godot/project:/project n24q02m/better-godot-mcp

The image is published for amd64 and arm64. Mount your project directory so the server can read and write scene, script, and resource files.

Smithery

better-godot-mcp ships a smithery.yaml so it can be discovered and deployed through Smithery. Smithery launches the server over stdio via npx -y @n24q02m/better-godot-mcp, and no configuration is required to start -- the server has no credentials and reads your local Godot project files directly.

Documentation

Full setup guide at mcp.n24q02m.com/servers/better-godot-mcp/setup/ -- install steps for Claude Code, Codex, Gemini CLI, Cursor, Windsurf, and mcp.json.

Install with AI agent -- paste this to your AI coding agent:

Install MCP server better-godot-mcp following the steps at https://raw.githubusercontent.com/n24q02m/claude-plugins/main/plugins/better-godot-mcp/setup-with-agent.md

Tools

Tool	Actions	Description
`project`	`info`, `version`, `run`, `stop`, `settings_get`, `settings_set`, `export`	Project metadata, run/stop, and settings
`scenes`	`create`, `list`, `info`, `delete`, `duplicate`, `set_main`	Scene file management
`nodes`	`add`, `remove`, `rename`, `list`, `set_property`, `get_property`	Scene tree node manipulation
`scripts`	`create`, `read`, `write`, `attach`, `list`, `delete`	GDScript file CRUD
`editor`	`launch`, `status`	Launch Godot editor and check status
`config`	`status`, `set`, `detect_godot`, `check`	Server configuration and environment detection
`resources`	`list`, `info`, `delete`, `import_config`	Resource file management
`input_map`	`list`, `add_action`, `remove_action`, `add_event`	Input action and event mapping
`signals`	`list`, `connect`, `disconnect`	Signal connections
`animation`	`create_player`, `add_animation`, `add_track`, `add_keyframe`, `list`	Animation players and tracks
`tilemap`	`create_tileset`, `add_source`, `set_tile`, `paint`, `list`	TileMap and TileSet management
`shader`	`create`, `read`, `write`, `get_params`, `list`	Shader file CRUD with Godot 4 syntax
`physics`	`layers`, `collision_setup`, `body_config`, `set_layer_name`	Collision layers and physics bodies
`audio`	`list_buses`, `add_bus`, `add_effect`, `create_stream`	Audio bus and effect management
`navigation`	`create_region`, `add_agent`, `add_obstacle`	Navigation regions, agents, and obstacles
`ui`	`create_control`, `set_theme`, `layout`, `list_controls`	UI control creation and theming
`help`	-	Get full documentation for any tool

Comparison

How better-godot-mcp stacks up against direct competitors in each pillar:

Capability	better-godot-mcp	Coding-Solo/godot-mcp	bradypp/godot-mcp	tugcantopaloglu/godot-mcp
Scene file management	Yes (`scenes`: create/list/info/delete/duplicate/set_main)	Yes (create/save)	Yes (create/save)	Yes (create/read/modify)
Node tree manipulation	Yes (`nodes`: add/remove/rename/list/get+set_property)	Partial (add only)	Yes (add/edit/remove)	Yes (add/remove/reparent)
GDScript file CRUD	Yes (`scripts`: create/read/write/attach/list/delete)	No	No	Partial (create from template + runtime eval)
Shader file CRUD	Yes (`shader`: create/read/write/get_params/list)	No	No	Partial (create/read .gdshader)
Animation authoring	Yes (`animation`: player/track/keyframe)	No	No	Yes (player/tween/state machine)
TileMap / TileSet	Yes (`tilemap`: tileset/source/set_tile/paint)	No	No	Yes (TileMapLayer cells)
Physics layers / bodies	Yes (`physics`: layers/collision/body_config)	No	No	Yes (collision/joints/raycast)
Audio bus management	Yes (`audio`: buses/effects/streams)	No	No	Yes (buses/routing/effects)
Navigation setup	Yes (`navigation`: region/agent/obstacle)	No	No	Yes (navigation)
UI control authoring	Yes (`ui`: control/theme/layout)	No	Partial (via add node)	Yes (controls/themes/menus)
Input map editing	Yes (`input_map`: action/event)	No	No	Yes (actions/key bindings)
Signal connections	Yes (`signals`: connect/disconnect/list)	No	No	Yes (connect/emit/await)
Launch editor / run project	Yes (`editor`, `project` run/stop)	Yes	Yes	Yes
Works without running editor	Yes (text-based `.tscn` parsing)	Yes (headless GDScript bridge)	Yes (headless GDScript bridge)	Partial (CLI headless or live TCP socket)
No credentials stored (TC-Local)	Yes	Yes	Yes	Yes
stdio + HTTP transports	Yes (stdio default + `--http`)	No (stdio only)	No (stdio only)	No (stdio only)
Docker image (amd64 + arm64)	Yes	No	No	No
Token-tiered tool descriptions	Yes (compact + on-demand `help`)	No	No	No

Configuration

The 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 the defaults.

Variable	Required	Default	Description
`GODOT_PROJECT_PATH`	No	-	Default project path (tools also accept a `project_path` param)
`GODOT_PATH`	No	Auto-detected	Path to the Godot binary

HTTP transport

The server runs over stdio by default. To serve over Streamable HTTP instead, pass --http or set MCP_TRANSPORT=http (TRANSPORT_MODE=http is also accepted). HTTP mode exposes an unauthenticated /mcp endpoint -- there are no credentials to protect, so it is meant for trusted local or self-hosted use.

Variable	Required	Default	Description
`MCP_TRANSPORT`	No	`stdio`	Set to `http` for Streamable HTTP transport
`PORT`	No	`0` (auto-assign)	HTTP port (HTTP mode only)
`HOST`	No	Server default	HTTP host (HTTP mode only)

Limitations

Requires a Godot 4.x project structure; a Godot binary is optional for file operations
Scene files (.tscn) are parsed/modified via text manipulation, not Godot's internal API
run/stop/export actions require Godot binary to be installed
Docker mode has limited filesystem access (mount your project directory)

CLI

The better-godot-mcp binary runs the MCP server by default (stdio; add --http for Streamable HTTP). It also exposes two diagnostic subcommands for checking your Godot environment before wiring up an MCP client.

Command	Description
`better-godot-mcp`	Start the MCP server (stdio default; `--http` for Streamable HTTP)
`better-godot-mcp detect`	Print the detected Godot binary as JSON (path, version, source); exits non-zero when none is found
`better-godot-mcp doctor`	Health-check the Godot binary and the current project (`GODOT_PROJECT_PATH`, else the working directory)

# Detect the Godot binary (JSON output)
npx -y @n24q02m/better-godot-mcp detect

{
  "found": true,
  "path": "/path/to/godot",
  "version": {
    "major": 4,
    "minor": 7,
    "patch": 1,
    "label": "stable.official",
    "raw": "4.7.1.stable.official"
  },
  "source": "system"
}

# Health-check the Godot binary and project
npx -y @n24q02m/better-godot-mcp doctor

[ok] godot binary: /path/to/godot (source: system)
[ok] godot version: 4.7.1.stable.official
[warn] project: no project.godot found at /path/to/cwd (set GODOT_PROJECT_PATH)

detect exits 1 when no Godot binary is found; doctor exits 1 when the binary is missing (a missing project.godot is only a warning).

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 dev          # stdio mode (default)
bun run dev:http     # Streamable HTTP mode

Trust model

This plugin implements TC-Local (no auth required -- no credentials stored). See the trust model reference for full classification.

Mode	Storage	Encryption	Who can read your data?
stdio (default)	N/A (no credentials)	N/A	N/A
HTTP self-host	N/A (no credentials)	N/A	N/A

License

Apache-2.0 -- See LICENSE.

Available Tools

17 tools

animationC

Animation management. Actions: create_player|add_animation|add_track|add_keyframe|list. Use help tool for full docs.

Inputs: action (required), loop, name, parent, +7 more. Returns: object

audioC

Audio bus and stream management. Actions: list_buses|add_bus|add_effect|create_stream. Use help tool for full docs.

Inputs: action (required), bus, name, parent, +6 more. Returns: object

configA

Idempotent

Server configuration and environment.

Actions (required params -> optional):

status: current config
set (key, value): update setting
detect_godot: find Godot binary path
check: verify project and Godot availability

Inputs: action (required), key, value. Returns: object

editorA

Idempotent

Godot editor control.

Actions (required params -> optional):

launch (-> project_path): open editor
status (-> project_path): check if editor is running

For running the game, use project(action="run") instead.

Inputs: action (required), project_path. Returns: object

helpA

Read-onlyIdempotent

Full documentation. Omit topic for the overview; use a topic when compressed descriptions are insufficient.

Inputs: topic.

input_mapA

Destructive

Input action management.

Actions (required params -> optional):

list (-> project_path): all input actions
add_action (action_name -> deadzone=0.5, project_path)
remove_action (action_name -> project_path)
add_event (action_name, event_type, event_value -> project_path)

event_type: key | mouse | joypad. event_value: e.g., KEY_SPACE.

Inputs: action (required), deadzone, event_type, action_name, +2 more. Returns: object

nodesA

Destructive

Scene node operations.

Actions (required params -> optional):

add (scene_path, name -> type="Node", parent=".", project_path)
remove (scene_path, name -> project_path)
rename (scene_path, name, new_name -> project_path)
list (scene_path -> project_path)
set_property (scene_path, name, property, value -> project_path)
get_property (scene_path, name, property -> project_path)

Node paths: relative to scene root using "/" (e.g., "Player/Sprite2D"). Use "." for root.

Inputs: action (required), name, type, value, +5 more. Returns: object

physicsC

Physics config. Actions: layers|collision_setup|body_config|set_layer_name. Use help tool for full docs.

Inputs: action (required), mass, name, dimension, +6 more. Returns: object

projectA

Godot project operations.

Actions (required params -> optional):

info (-> project_path): project metadata
version: Godot engine version
run (-> scene_path, project_path): launch game
logs (-> pid): last captured stdout/stderr lines from a run (default: most recently started)
stop: stop running game
settings_get (key -> project_path): read project setting
settings_set (key, value -> project_path): write project setting
export (preset, output_path -> project_path): export game build

Inputs: action (required), key, pid, value, +4 more. Returns: object

resourcesB

Destructive

Resource file management.

Actions (required params -> optional):

list (-> type, project_path): browse resources (type: image|audio|font|shader|scene|resource)
info (resource_path -> project_path): resource metadata
delete (resource_path -> project_path)
import_config (resource_path -> project_path): view import settings

Inputs: action (required), type, project_path, resource_path. Returns: object

scenesA

Destructive

Scene file (.tscn) CRUD.

Actions (required params -> optional):

create (scene_path -> root_type="Node2D", root_name, project_path)
list (-> project_path)
info (scene_path -> project_path)
delete (scene_path -> project_path)
duplicate (scene_path, new_path -> project_path)
set_main (scene_path -> project_path)

scene_path: relative to project root (e.g., "scenes/main.tscn"), NOT res:// prefix. Use nodes tool to edit nodes within a scene.

Inputs: action (required), new_path, root_name, root_type, +2 more. Returns: object

scriptsA

Destructive

GDScript file CRUD.

Actions (required params -> optional):

create (script_path -> extends="Node", content, project_path): generate template
read (script_path -> project_path)
write (script_path, content -> project_path): replace entire file
attach (script_path, scene_path, node_name -> project_path): link to scene node
list (-> project_path)
delete (script_path -> project_path)

script_path: relative to project root (e.g., "scripts/player.gd").

Inputs: action (required), content, extends, node_name, +3 more. Returns: object

shaderC

Godot shader management. Actions: create|read|write|get_params|list. Use help tool for full docs.

Inputs: action (required), content, shader_path, shader_type, +1 more. Returns: object

signalsA

Destructive

Signal connection management.

Actions (required params -> optional):

list (scene_path -> project_path): all signal connections
connect (scene_path, signal, from, to, method -> flags, project_path)
disconnect (scene_path, signal, from, to, method -> project_path)

Inputs: action (required), to, from, flags, +4 more. Returns: object

tilemapC

TileSet and TileMap management. Actions: create_tileset|add_source|set_tile|paint|list. Use help tool for full docs.

Inputs: action (required), tile_size, scene_path, project_path, +2 more. Returns: object

uiC

UI Control nodes and themes. Actions: create_control|set_theme|layout|list_controls. Use help tool for full docs.

Inputs: action (required), name, type, parent, +5 more. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

TDQS

B3.4/5.0

Scored 2026-09-09 22:25 across 17 tools

Disambiguation4/5

Each tool targets a distinct Godot subsystem, and explicit notes (e.g., editor launch vs project run) reduce confusion. Some overlap remains between project settings and config, and between scenes and generic resource management.

Naming Consistency4/5

Tool names follow a consistent single-noun domain pattern with verb-style actions underneath. Minor inconsistencies like plural scenes/nodes/scripts vs singular animation/shader and the underscore in input_map prevent a perfect score.

Tool Count4/5

At roughly 16-17 tools, the server sits at the upper edge of the ideal range, but each tool covers a separate Godot domain and earns its place. It is slightly heavy but not bloated.

Completeness4/5

The surface covers the core Godot development lifecycle: project, editor, scenes, scripts, resources, input, signals, rendering, physics, audio, navigation, and UI. Minor gaps exist, such as no generic resource creation and abbreviated documentation for several advanced domains.

Maintenance

ActivitySlowing

ResponsivenessOutdated data

Resources

Related MCP Connectors

Rengi ForgeB
io.github.MRRengi
Gamedev tools for AI agents: level design, renders, sprites, GLB optimizer. Pay per call with x402.
Games & Gamification Image & Video Processing Developer Tools
431
https://rengi.dev/mcp
StackFiestaA
dev.stackfiesta
Discover AI tools for game development — 100+ tools indexed by engine, task, and pricing.
Games & Gamification AI & Machine Learning Developer Tools
22
https://stackfiesta.dev/mcp
Sprixen
com.sprixen
AI game assets for agents: consistent sprites, 2D animations, tiles, maps, music and engine exports.
Games & Gamification Image & Video Processing Multimedia Processing
1
https://api.sprixen.com/v1/mcp
QuassLabs APIA
com.quasslabs
30+ deterministic dev and delivery tools: linting, metrics, diagrams, model advice, AI-text checks.
Code Analysis Developer Tools Software Architecture
371
https://api.quasslabs.com/mcp

Related MCP Servers

Better Notion MCP
Workplace & Productivity Content Management Systems Note Taking
n24q02m
A
license
A
quality
A
maintenance
Markdown-first MCP server for Notion that provides 7 composite action-based tools consolidating 28+ REST API endpoints, enabling AI agents to efficiently manage pages, databases, blocks, and content with automatic pagination and bulk operations.
Updated 2 days ago (2026-11-09 18:32 UTC)
10
97 npm
36
Apache 2.0
Godot MCP Unified
Developer Tools App Automation Software Architecture
pierrealexandreguillemin-a11y
A
license
Not graded
quality
F
maintenance
Enables complete natural language control of Godot Engine 4.5+ with 76 tools for managing scripts, scenes, nodes, animations, physics, tilemaps, audio, shaders, navigation, particles, UI, lighting, assets, and exports. Integrates with Claude Desktop, VS Code, and Ollama for AI-assisted game development.
Updated 18 days ago (2026-10-24 14:50 UTC)
192 npm
2
MIT
WET - Web Extended Toolkit
Research & Data Search Web Scraping
n24q02m
A
license
A
quality
A
maintenance
Web search (embedded SearXNG), content extraction, and library docs indexing with hybrid search. No API keys required.
Updated 2 days ago (2026-11-09 19:31 UTC)
6
24
Apache 2.0
Mnemo - Persistent AI Memory
Knowledge & Memory Workplace & Productivity
n24q02m
A
license
A
quality
A
maintenance
Persistent AI memory with SQLite hybrid search (FTS5 + semantic), built-in Qwen3 embedding, and rclone sync across machines.
Updated 2 days ago (2026-11-09 20:39 UTC)
15
13 npm
12
Apache 2.0

Better Godot MCP

Table of contents

Features

Install

Via npx (recommended)

MCP client config

Via Docker

Smithery

Documentation

Tools

Comparison

Configuration

HTTP transport

Limitations

CLI

Security

Build from source

Trust model

License

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Better Notion MCP

Godot MCP Unified

WET - Web Extended Toolkit

Mnemo - Persistent AI Memory