Skip to main content
Glama
neondeex

Godot MCP Server

by neondeex
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

Godot MCP Server

MCP server that bridges Claude Code with the Godot editor via WebSocket. This repo only provides the MCP server — the Godot addon must be installed separately.

Prerequisites

Install the Godot addon from: https://github.com/youichi-uda/godot-mcp-pro

The addon connects automatically to the MCP server at ws://localhost:6505 when the editor starts.

This repo is a free client for the premium addon Godot MCP Pro. Get the premium version here:

Related MCP server: Godot MCP Bridge

Setup

1. Clone this repo

git clone https://github.com/neondeex/GodotMCP-Pro-Free-Client
cd GodotMCP-Pro-Free-Client

2. Install dependencies

npm install

3. Start the server

npm start

Configure Claude Code

Add this to ~/.claude.json under mcpServers:

{
  "mcpServers": {
    "godot": {
      "command": "node",
      "args": ["/absolute/path/to/GodotMCP-Pro-Free-Client/index.js"]
    }
  }
}

Or via CLI:

claude mcp add godot node -- /absolute/path/to/GodotMCP-Pro-Free-Client/index.js

Available Tools

167 tools across 25 categories:

Category

Tools

Description

Project

9

Project info, filesystem, settings, autoloads

Scene

9

Create, open, save, list, play scenes

Node

13

Add, delete, move, rename, signals, properties

Script

7

List, read, create, edit, attach, validate GDScript

Editor

13

State, errors, screenshots, settings, EditorScript

Input

5

Simulate keyboard, mouse, actions, sequences

Runtime

18

Live game inspection, properties, signals, physics

Animation

6

List, create, delete animations and keyframes

Animation Tree

8

State machines, transitions, blend parameters

Audio

6

Buses, effects, volumes, AudioStreamPlayer

Batch

7

Multi-node operations, scene analysis

Shader

6

Create, read, edit shaders, assign materials

Export

3

List presets, export project, preset info

Resource

4

Read, edit, create, preview Godot resources

Input Map

2

Get and set input action bindings

Scene 3D

6

Meshes, lights, materials, camera, environment

Physics

6

Collision shapes, physics bodies, layers, raycast

Analysis

6

Unused resources, signal flow, dependencies, metrics

Navigation

5

NavRegion, NavAgent, bake mesh, layer config

Particles

5

Create particles, materials, presets, properties

Profiling

2

Performance monitors (game + editor)

Testing

5

Test scenarios, assertions, stress tests

Theme

7

Colors, fonts, styleboxes, apply to nodes

Tilemap

6

Set cells, fill rect, clear, get info

Android

3

List devices, deploy, preset info

How It Works

Claude Code  ──(MCP/stdio)──▶  MCP Server  ──(WebSocket :6505)──▶  Godot addon

  1. Claude invokes a tool (e.g. get_scene_tree)

  2. The MCP server forwards it as a JSON-RPC request to the Godot addon

  3. Godot executes the command and returns the result

  4. The MCP server relays the result back to Claude

The server tries ports 6505–6514 in order and binds to the first available one.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Godot MCP Server

    ricky-yosh
    A
    license
    A
    quality
    D
    maintenance
    Connects Claude directly to Godot 4 projects to read and manipulate scenes, nodes, scripts, and assets within the editor. It enables real-time scene tree management, script editing, and resource configuration through a local Node.js bridge and GDScript plugin.
    16
    379 npm
    MIT

  • Godot MCP Bridge

    farrasfadhils
    F
    license
    C
    quality
    F
    maintenance
    Enables AI assistants to control Godot game engine projects through a WebSocket bridge. Supports scene editing, node manipulation, script management, and project introspection via 163 registered tools.
    100
    1
    -

  • godot-mcp

    Bouelon
    F
    license
    Not graded
    quality
    D
    maintenance
    Bridges AI assistants with the Godot 4 editor, exposing tools to inspect scenes, create nodes, modify properties, capture screenshots, debug scripts, and manage project files via the Model Context Protocol.
    -

  • godot-mcp-bridge

    TomasLucasUTN
    A
    license
    Not graded
    quality
    A
    maintenance
    Let Claude, Cursor, or any MCP-compatible AI work inside your Godot project: read and edit scenes, write and validate scripts, run the game, drive it, and read the errors — without copy-pasting anything.
    5
    MIT