whatisgithub

What is godot-mcp?

coding-solo/godot-mcp — explained in plain English

Analysis updated 2026-05-18

3,629JavaScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

Godot MCP connects AI coding assistants to the Godot game engine so they can run projects, read errors, and edit scenes directly.

Mindmap

mindmap
  root((godot-mcp))
    What it does
      Launches Godot editor
      Runs projects
      Captures debug output
      Controls execution
    Tech stack
      JavaScript
      TypeScript
      Node.js
      GDScript
    Use cases
      AI-assisted debugging
      Scene creation
      UID management
    Setup
      Requires Godot installed
      Requires Node.js 18 plus
      MCP-compatible client

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Let an AI coding assistant run a Godot project and read back console errors to debug it automatically.

USE CASE 2

Have an AI agent create and edit Godot scenes, adding nodes and setting properties without manual editor clicks.

USE CASE 3

Export 3D scene data as a MeshLibrary resource for GridMap through an automated agent workflow.

What is it built with?

JavaScriptTypeScriptNode.jsGodotGDScript

How does it compare?

coding-solo/godot-mcpgeuis/helium-cssmelvin-abraham/google-assistant-unofficial-desktop-client
Stars3,6293,6353,635
LanguageJavaScriptJavaScriptJavaScript
Setup difficultymoderateeasymoderate
Complexity3/52/53/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Godot Engine and Node.js 18 or higher already installed locally.

MIT license, use freely for any purpose including commercial use, keep the copyright notice.

So what is it?

Godot MCP is a server that lets AI coding assistants control the Godot game engine directly. MCP stands for Model Context Protocol, which is a standard that tools like Claude, Cursor, and Cline use to communicate with external programs. By connecting this server to one of those AI tools, you can ask the AI to open a Godot project, run it, read the output, and make changes, without you having to switch windows and copy-paste error messages back and forth. Godot is a free, open-source game engine used to make 2D and 3D games. If you are building a game in Godot and using an AI assistant to help write code, the usual friction is that the AI cannot see what happens when the game actually runs. Godot MCP closes that gap by giving the AI a live connection to Godot. The AI can launch the editor, start the game in debug mode, capture the console output and any error messages, and stop the game when it is done, all from within the conversation. Beyond running the project, the server also exposes scene management tools. The AI can create new scenes, add nodes to existing ones, set properties on those nodes, load sprites and textures, and export 3D scene data as resources for use in grid-based maps. For Godot 4.4 and newer, it also handles UID management, which is an internal file referencing system that Godot uses to keep track of assets when files are moved. Setup is a single command. For Claude Code, you run one line in the terminal to register the MCP server, then restart. Cursor and Cline have their own config files where you add a short JSON block. Node.js 18 or newer must be installed alongside Godot itself. The README describes an architecture split between simple commands (which call Godot directly via its CLI) and more complex operations (which use a bundled GDScript that Godot runs as a headless process).

Copy-paste prompts

Prompt 1
Set up godot-mcp with Claude Code so it can launch and debug my Godot project automatically.
Prompt 2
Use godot-mcp to create a new Godot scene with a CharacterBody2D root node and add a sprite to it.
Prompt 3
Show me how to configure the GODOT_PATH environment variable for godot-mcp on my system.
Prompt 4
Use godot-mcp to run my Godot project, capture the debug output, and tell me what is failing.

Frequently asked questions

What is godot-mcp?

Godot MCP connects AI coding assistants to the Godot game engine so they can run projects, read errors, and edit scenes directly.

What language is godot-mcp written in?

Mainly JavaScript. The stack also includes JavaScript, TypeScript, Node.js.

What license does godot-mcp use?

MIT license, use freely for any purpose including commercial use, keep the copyright notice.

How hard is godot-mcp to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is godot-mcp for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.