Godot MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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-Client2. Install dependencies
npm install3. Start the server
npm startConfigure 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.jsAvailable 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 addonClaude invokes a tool (e.g.
get_scene_tree)The MCP server forwards it as a JSON-RPC request to the Godot addon
Godot executes the command and returns the result
The MCP server relays the result back to Claude
The server tries ports 6505–6514 in order and binds to the first available one.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Persistent memory for Claude Code and Cursor. Stop re-explaining your project every session.
Make all the audio for your game from a single prompt. Describe your game and your AI assistant plans every sound it needs (sound effects, ambience loops, music tracks and character voice lines), then generates them all in one go. You get several AI versions of each sound and keep the ones you like. Sounds are organized per game in folders and scenes, and the free Godot plugin installs them into your project, ready to play with one line of code. Works with Claude, Claude Code, Cursor and any MCP client, with OAuth login (no API key needed). Free plan included; sounds can be used in commercial games.
Your own Claude designs and codes Godot 4 games; each build is tested with real screenshots.
Use AI models for chat, image, and video generation from Claude Code and other MCP hosts.
Related MCP Servers
- AlicenseAqualityDmaintenanceConnects 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.16775 npmMIT
- FlicenseCqualityDmaintenanceEnables 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.1001-
- FlicenseNot gradedqualityDmaintenanceBridges 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.-
- AlicenseNot gradedqualityBmaintenanceLet 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.10MIT