Log inSubmit server
Godot MCP logo

Godot MCP

by Coding-Solo

Controls Godot projects through MCP, including editor launch, project execution, debugging, scene operations, and UID management.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Godot MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "coding-solo-godot-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@coding-solo/godot-mcp"
      ],
      "env": {
        "GODOT_PATH": "YOUR_VALUE_HERE",
        "DEBUG": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 14 tools correctly (1mo ago).

Overview

Coding-Solo/godot-mcp MCP server lets AI agents interact with the Godot game engine through an MCP-compatible client. It uses Godot's command-line interface for straightforward actions and a bundled GDScript for scene and resource operations. Available capabilities include launching the editor, running and stopping projects, collecting debug output, inspecting projects, managing scenes, and handling UIDs in Godot 4.4 or later. Reach for it when an agent needs to test, inspect, or modify a local Godot project, provided Godot and Node.js are installed.

Use cases

  • Launch a Godot editor for a selected project
  • Run a project and inspect its debug output
  • Create scenes and add configured nodes
  • Export 3D scenes for GridMap use
  • Refresh UID references in Godot 4.4+ projects

Key features

  • Godot editor and project execution control
  • Debug output and error retrieval
  • Project discovery and structural analysis
  • Scene and node management
  • Sprite loading and MeshLibrary export
  • UID operations for Godot 4.4+

Tools14

What Godot MCP lets your agent do. Expand a tool for its parameters.

Verified live~1.1k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

30/31 checks healthy over the last 78d

Supply-chain signal

1 high-severity advisory on record for this package. Most advisories affect transitive dependencies and may not be exploitable in this server's actual usage — this is a directional signal, not a security audit.

Critical 0High 1Medium 0Low 0

Scanned 8d ago via OSV.dev · @coding-solo/godot-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars6.4kStargazers on the source repository.
npm downloads11kPackage downloads in the last 30 days.
Last commit6mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed14Callable tools this server registers over MCP.
Directory activity12 viewsConfig copies, upvotes, and views on AllMCPs.

How Godot MCP works

What Coding-Solo/godot-mcp MCP server does

Coding-Solo/godot-mcp MCP server exposes Godot project operations to AI agents through the Model Context Protocol. It can open the editor for a selected project, start a project in debug mode, stop execution, and return console output or error messages. It can also report the installed Godot version, search a directory for projects, and provide structural information about a project.

Scene-related operations cover creating a scene with a chosen root node type, inserting nodes with configurable properties, loading a sprite or texture into a Sprite2D node, saving scenes, and exporting a 3D scene as a MeshLibrary resource for GridMap use. For Godot 4.4 and newer, the server includes operations for reading file UIDs and refreshing UID references by resaving resources.

How it works

Coding-Solo/godot-mcp MCP server runs locally as a Node.js package and communicates with an MCP client over the client’s configured command transport. Basic requests, such as opening the editor or reading project information, invoke Godot’s built-in command-line functions directly. More involved scene operations are delegated to one bundled GDScript file, godot_operations.gd.

The operations script receives an operation name and parameters as JSON. This design lets the server pass different scene-management requests to Godot without creating a separate temporary script for every request. The target project must be a directory containing a project.godot file.

Setup and configuration

Install Godot Engine and Node.js 18 or later with npm before configuring Coding-Solo/godot-mcp MCP server. An MCP-capable AI client is also required. The package can be launched with npx -y @coding-solo/godot-mcp, or the repository can be built locally with npm install, followed by npm run build; a client can then point to build/index.js.

Godot is detected automatically when possible. Set GODOT_PATH when the executable is not found automatically or when a particular installation should be used. Set DEBUG to true to enable detailed server-side logging. After adding the server to a client, restart or refresh the client if its tools do not appear.

The documented client configurations include Cursor and Cline. Claude Code is also shown as a supported setup method, although it is not one of the client labels represented in this directory’s compatibility field.

Tools and capabilities

Coding-Solo/godot-mcp MCP server provides the following operation groups:

  • Launch the Godot editor for a project.
  • Run and stop a project programmatically.
  • Read debug output and error messages.
  • Retrieve the installed Godot version.
  • Find projects under a specified directory.
  • Inspect project details and structure.
  • Create scenes and add nodes with selected properties.
  • Load sprites or textures into Sprite2D nodes.
  • Export 3D scenes as MeshLibrary resources.
  • Save scenes, including variant-saving options.
  • Read file UIDs and update project UID references on Godot 4.4+.

These capabilities are intended for local Godot workflows where the agent needs feedback from project execution or direct scene manipulation rather than only editing source files.

Limitations and notes

The server depends on a working Godot installation and a valid project path. If Godot cannot be located, configure GODOT_PATH; if the project path does not contain project.godot, project operations will fail. Connection problems may require confirming that the MCP process is running and restarting the AI client.

The material does not document remote hosting, API credentials, OAuth, or a Godot version range beyond the specific Godot 4.4+ requirement for UID operations. The repository is released under the MIT license.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Godot MCP

Run `npx -y @coding-solo/godot-mcp` through your MCP client configuration. The documented setup also requires Godot, Node.js 18 or later, npm, and an MCP-compatible client.

Add a command-type MCP server in Cursor with `npx @coding-solo/godot-mcp`, or create a project `.cursor/mcp.json` entry using `npx` and the package name.

Set the `GODOT_PATH` environment variable to the Godot executable when automatic detection does not find the correct installation.

It can create scenes, add nodes with properties, load sprites or textures into Sprite2D nodes, export 3D scenes as MeshLibrary resources, save scenes, and manage UIDs on Godot 4.4 or later.

Related MCP servers

All in Gaming All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewGodot MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/coding-solo-godot-mcp?style=directory)](https://allmcps.com/mcp/coding-solo-godot-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/coding-solo-godot-mcp"><img src="https://allmcps.com/api/badge/coding-solo-godot-mcp?style=directory" alt="Godot MCP on AllMCPs" /></a>