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

| Project | Tagline | Tag | |---|---|---| | better-code-review-graph | Knowledge graph for token-efficient code reviews -- fixed search, configurabl... | MCP | | better-email-mcp | IMAP/SMTP email server for AI agents -- 6 composite tools with multi-account ... | MCP | | better-godot-mcp | Composite MCP server for Godot Engine -- 17 mega-tools for AI-assisted game d... | MCP | | better-notion-mcp | Markdown-first Notion API server for AI agents -- 10 composite tools replacin... | MCP | | better-telegram-mcp | MCP server for Telegram with dual-mode support: Bot API (httpx) for quick bot... | MCP | | claude-plugins | Full documentation: mcp.n24q02m.com — unified docs for all 8 servers + the mc... | Marketplace | | imagine-mcp | Production-grade MCP server for image and video understanding + generation ac... | MCP | | jules-task-archiver | Chrome Extension for bulk operations on Jules tasks via batchexecute API -- a... | Tooling | | mcp-core | Unified MCP Streamable HTTP 2025-11-25 transport, OAuth 2.1 Authorization Ser... | 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 | | web-core | Shared web infrastructure package for search, scraping, HTTP security, and st... | Library | | wet-mcp | Open-source MCP Server for web search, content extraction, library docs & mul... | MCP |

Table of contents

• Features
• Status
• Documentation
• Tools
• Configuration
• Security
• Build from Source
• Trust Model
• License

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

Status

2026-05-02 -- Architecture stabilization update

Past months saw significant churn around credential handling and the daemon-bridge auto-spawn pattern. This caused multi-process races, browser tab spam, and inconsistent setup UX across plugins. As of v<auto>, the architecture is stable: 2 clean modes (stdio + HTTP), no daemon-bridge layer, no auto-spawn from stdio.

Apologies for the instability period. If you encountered issues with prior versions, please update to v<auto>+ and follow the current docs/setup-manual.md -- most prior workarounds are no longer needed.

Related plugins from the same author:

• wet-mcp -- Web search + content extraction
• mnemo-mcp -- Persistent AI memory
• imagine-mcp -- Image/video understanding + generation
• better-notion-mcp -- Notion API
• better-email-mcp -- Email management
• better-telegram-mcp -- Telegram
• better-godot-mcp -- Godot Engine
• better-code-review-graph -- Code review knowledge graph

All plugins share the same architecture -- install once, learn pattern transfers.

Documentation

Full docs at mcp.n24q02m.com/servers/better-godot-mcp/:

• Setup -- install methods for Claude Code, Codex, Gemini CLI, Cursor, Windsurf, mcp.json
• Modes overview -- stdio / local-relay / remote-relay / remote-oauth
• Multi-user setup -- per-JWT-sub credential model

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 |

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 | |:---------|:---------|:--------|:------------| | GODOT_PROJECT_PATH | No | - | Default project path (tools also accept project_path param) | | GODOT_PATH | 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 API
• run/stop/export actions require Godot binary to be installed
• Docker 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 dev

Trust Model

This plugin implements TC-Local (no auth required -- no credentials stored). See mcp-core/docs/TRUST-MODEL.md 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

MIT -- See LICENSE.