sterion66 avatar

Godot

sterion66/godot-mcp-server

A full-featured bridge between Claude and Godot 4 projects that runs entirely within a sandboxed workspace directory. Ships with 40+ tools spanning project scaffolding, GDScript generation, scene and resource parsing, asset discovery, and optional runtime execution. The security model locks all file operations to a single configurable root (defaulting to ~/godot-games), with explicit environment flags required to enable game launch or script execution. You get template-driven code generation for movement controllers and state machines, direct Asset Library search and download, unused asset detection, and log parsing. Supports stdio for Cursor and Claude Desktop, plus optional HTTP transport. If you're building Godot games with AI assistance and want structured control over project files without exposing your entire filesystem, this handles the plumbing.

tools
40
transport
STDIO
last updated
Apr 13, 2026

Tools

40 tools

Public tool metadata for what this MCP can expose to an agent.

godot_get_workspaceShow MCP sandbox directory (`GODOT_MCP_ROOT`)

Show MCP sandbox directory (`GODOT_MCP_ROOT`)

No parameter schema in public metadata yet.

godot_find_projectLocate project root (walk-up or workspace scan)

Locate project root (walk-up or workspace scan)

No parameter schema in public metadata yet.

godot_list_projectsList every `project.godot` under the workspace

List every `project.godot` under the workspace

No parameter schema in public metadata yet.

godot_create_projectCreate `project.godot` + starter scene under the workspace

Create `project.godot` + starter scene under the workspace

No parameter schema in public metadata yet.

godot_get_project_infoGet project details

Get project details

No parameter schema in public metadata yet.

godot_get_project_settingsParse project.godot (includes `editor_plugins_enabled` read-only)

Parse project.godot (includes `editor_plugins_enabled` read-only)

No parameter schema in public metadata yet.

godot_get_project_filesList all project files

List all project files

No parameter schema in public metadata yet.

godot_refresh_projectRescan scenes/scripts/resources counts

Rescan scenes/scripts/resources counts

No parameter schema in public metadata yet.

godot_list_scenesList `.tscn` files

List `.tscn` files

No parameter schema in public metadata yet.

godot_list_scriptsList `.gd` files

List `.gd` files

No parameter schema in public metadata yet.

godot_list_resourcesList `.tres` files

List `.tres` files

No parameter schema in public metadata yet.

godot_list_autoloadList autoload singletons

List autoload singletons

No parameter schema in public metadata yet.

godot_list_editor_pluginsInstalled addons vs enabled in project.godot (enable plugins in the Godot editor)

Installed addons vs enabled in project.godot (enable plugins in the Godot editor)

No parameter schema in public metadata yet.

godot_find_assetsFind by extension

Find by extension

No parameter schema in public metadata yet.

godot_find_unused_filesFind unreferenced assets

Find unreferenced assets

No parameter schema in public metadata yet.

godot_find_by_patternGlob pattern search

Glob pattern search

No parameter schema in public metadata yet.

godot_search_contentRegex search in files

Regex search in files

No parameter schema in public metadata yet.

godot_create_scriptCreate new GDScript

Create new GDScript

No parameter schema in public metadata yet.

godot_create_sceneCreate new scene

Create new scene

No parameter schema in public metadata yet.

godot_create_resourceCreate new resource

Create new resource

No parameter schema in public metadata yet.

godot_create_code_templateTemplate scripts

Template scripts

No parameter schema in public metadata yet.

godot_read_sceneParse scene file

Parse scene file

No parameter schema in public metadata yet.

godot_read_scriptParse GDScript

Parse GDScript

No parameter schema in public metadata yet.

godot_validate_sceneValidate scene

Validate scene

No parameter schema in public metadata yet.

godot_validate_scriptValidate syntax

Validate syntax

No parameter schema in public metadata yet.

godot_edit_fileReplace content

Replace content

No parameter schema in public metadata yet.

godot_write_fileWrite file

Write file

No parameter schema in public metadata yet.

godot_get_file_infoFile metadata

File metadata

No parameter schema in public metadata yet.

godot_find_godot_executableLocate Godot

Locate Godot

No parameter schema in public metadata yet.

godot_check_versionGodot version

Godot version

No parameter schema in public metadata yet.

godot_run_gameRun headless

Run headless

No parameter schema in public metadata yet.

godot_execute_scriptRun GDScript

Run GDScript

No parameter schema in public metadata yet.

godot_get_logRead logs

Read logs

No parameter schema in public metadata yet.

godot_watch_filesConfigure watcher

Configure watcher

No parameter schema in public metadata yet.

godot_get_node_infoNode type hints

Node type hints

No parameter schema in public metadata yet.

godot_generate_uidGenerate UID

Generate UID

No parameter schema in public metadata yet.

godot_search_assetlibSearch Asset Library

Search Asset Library

No parameter schema in public metadata yet.

godot_get_asset_infoAsset details

Asset details

No parameter schema in public metadata yet.

godot_download_assetDownload / extract asset (promotes nested `addons/`)

Download / extract asset (promotes nested `addons/`)

No parameter schema in public metadata yet.

godot_browse_githubSearch GitHub

Search GitHub

No parameter schema in public metadata yet.

Sponsors

Readme

Godot MCP Server

CI Python 3.10+ License: MIT

A comprehensive FastMCP server for Godot 4.x game development. Provides tooling for AI-assisted workflows: project management, file operations, asset discovery, GDScript development, and optional Godot execution.

Contributing · Security

Security model: All Godot projects, file writes, and Asset Library downloads are restricted to a single workspace directory on your machine (default ~/godot-games). The server refuses paths outside that tree. See Workspace setup.


View the full README on GitHub

Details

Repository
github.com/sterion66/godot-mcp-server
Category
Design & Creative
Package
godot-mcp-server
Transport
STDIO
Registry
MCP registry, active

Related Design & Creative MCP servers

View all
1yanislav-igonin avatarRandom Designyanislav-igonin/random-design-mcpGenerate randomized English Markdown frontend design directions from curated catalogs.0stars
2builderio avatarAgent-Native Designbuilderio/agent-nativeAgent-Native design tool - create and edit visual designs with agent assistance7.6Kstars
3vishalsachdev avatarCanvas Mcpvishalsachdev/canvas-mcpCanvas LMS integration for students and educators with optional privacy controls322stars
4dmontgomery40 avatarMCP 3D Printer Serverdmontgomery40/mcp-3d-printer-serverConnects MCP to major 3D printer APIs (Orca, Bambu, OctoPrint, Klipper, Duet, Repetier, Prusa, Creality). Control prints, monitor status, and perform advanced S190stars
5funseaai avatarFunseaAI Unity MCPfunseaai/unity-mcpstdio bridge for the local Unity Editor MCP server from FunseaAI/unity-mcp.100stars
6codeturion avatarUnity API Documentationcodeturion/unity-api-mcpAccurate Unity API docs (2022/2023/6) for AI agents. Prevents hallucinated signatures.66stars