Better Godot MCP
๐ ๐ ๐ ๐ช ๐ง - 18 composite tools for structured Godot 4.x interaction: scenes, nodes, GDSc
What is Better Godot MCP?
Better Godot MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ๐ ๐ ๐ ๐ช ๐ง - 18 composite tools for structured godot 4.x interaction: scenes, nodes, gdsc
๐ ๐ ๐ ๐ช ๐ง - 18 composite tools for structured Godot 4.x interaction: scenes, nodes, GDSc
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP protocol support
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @n24q02m/better-godot-mcpManual Installation
npx -y @n24q02m/better-godot-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Better Godot MCP
Better Godot MCP is a TypeScript MCP server that exposes 17 composite tools for structured, AI-driven interaction with Godot 4.x game projects. Instead of raw file edits, it provides purpose-built tools for every layer of a Godot project: scenes, nodes, GDScript files, animations, tilemaps, shaders, physics, audio, navigation, and UI theming. It auto-detects Godot installations from common paths and PATH, supports both stdio and HTTP transport modes, and runs on macOS, Windows, Linux, and Docker โ making it practical for any Godot development workflow guided by Claude or Cursor.
Prerequisites
- Godot 4.x installed (auto-detected from common install locations or PATH)
- Node.js 18 or higher
- Claude Code, Cursor, or another MCP-compatible AI client
- A Godot 4.x project to work with
Install the npm package
Install Better Godot MCP globally or use it directly via npx. The package is published as @n24q02m/better-godot-mcp.
npm install -g @n24q02m/better-godot-mcp
# Or use without installing:
npx -y @n24q02m/better-godot-mcpAdd to your MCP client configuration
Register the server in your Claude Desktop or Claude Code configuration file. Optionally specify the Godot project path and binary location via environment variables.
{
"mcpServers": {
"better-godot-mcp": {
"command": "npx",
"args": ["-y", "@n24q02m/better-godot-mcp"],
"env": {
"GODOT_PROJECT_PATH": "/path/to/your/godot/project",
"GODOT_PATH": "/path/to/godot4"
}
}
}
}Verify Godot detection
Use the config tool to confirm Better Godot MCP has found your Godot installation and project. If GODOT_PATH is not set, the server searches common install locations automatically.
# In Claude, ask:
# "Use the better-godot-mcp config tool to show the detected Godot version and project path"Launch Godot editor through the MCP server
Use the editor tool to start the Godot editor for your project, then check its status.
# In Claude, ask:
# "Launch the Godot editor for my project using the better-godot-mcp editor tool"Better Godot MCP Examples
Client configuration
Claude Desktop configuration for Better Godot MCP with explicit project and binary paths.
{
"mcpServers": {
"better-godot-mcp": {
"command": "npx",
"args": ["-y", "@n24q02m/better-godot-mcp"],
"env": {
"GODOT_PROJECT_PATH": "/Users/me/projects/my-game",
"GODOT_PATH": "/Applications/Godot_v4.app/Contents/MacOS/Godot"
}
}
}
}Prompts to try
Use these prompts in Claude after Better Godot MCP is connected to automate common Godot 4.x development tasks.
- "Create a new scene called 'Player.tscn' with a CharacterBody2D root node"
- "Add a CollisionShape2D node to the Player scene and set its shape to a capsule"
- "Create a GDScript called 'player_controller.gd' with a basic movement handler and attach it to the Player node"
- "Connect the 'area_entered' signal on the HitBox node to the player controller script"
- "List all scenes in the project and show me which ones have AnimationPlayer nodes"
- "Set up a TileMap with a 16x16 tile size for the Level1 scene"Troubleshooting Better Godot MCP
Godot binary not found even though it is installed
Set the GODOT_PATH environment variable to the exact path of your Godot 4 executable, for example '/Applications/Godot_v4.app/Contents/MacOS/Godot' on macOS or 'C:\Program Files\Godot\Godot_v4.exe' on Windows. Add it to the env block in your MCP config.
Scene or node tools fail with 'project not found' errors
Set GODOT_PROJECT_PATH to the directory containing your project.godot file. If this env var is unset, the server may be looking in the wrong working directory.
npx -y @n24q02m/better-godot-mcp hangs on first run
The first run downloads the package from npm. If your network is slow or npm is rate-limiting, try installing globally first with `npm install -g @n24q02m/better-godot-mcp` and then changing the command in your config to `better-godot-mcp` without npx.
Frequently Asked Questions about Better Godot MCP
What is Better Godot MCP?
Better Godot MCP is a Model Context Protocol (MCP) server that ๐ ๐ ๐ ๐ช ๐ง - 18 composite tools for structured godot 4.x interaction: scenes, nodes, gdsc It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Better Godot MCP?
Install via npm with the command: npx -y @n24q02m/better-godot-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Better Godot MCP?
Better Godot MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Better Godot MCP free to use?
Yes, Better Godot MCP is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Better Godot MCP Alternatives โ Similar Developer Tools Servers
Looking for alternatives to Better Godot MCP? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
โ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
โ 155.8kJava ้ข่ฏ & ๅ็ซฏ้็จ้ข่ฏๆๅ๏ผ่ฆ็่ฎก็ฎๆบๅบ็กใๆฐๆฎๅบใๅๅธๅผใ้ซๅนถๅใ็ณป็ป่ฎพ่ฎกไธ AI ๅบ็จๅผๅ
Gemini CLI
โ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
โ 87.3kโญ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
โ 86.0kModel Context Protocol Servers
CC Switch
โ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Better Godot MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Better Godot MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.