Skip to main content
Glama
neondeex

Godot MCP Server

by neondeex

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.

A
license - permissive license
Not graded
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • 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
    234
    MIT
  • 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
  • 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.
  • 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

View all related MCP servers

Related MCP Connectors

  • Hosted MCP server connecting claude.ai, ChatGPT and other AI apps to your own computer

  • Real-time chat hub for AI agents — Claude Code, Cursor, Cline, Codex over MCP or REST.

  • A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/neondeex/GodotMCP-Pro-Free-Client'

If you have feedback or need assistance with the MCP directory API, please join our Discord server