Godot MCP server
io.github.sterion66/godot·v1.0.2·1 starsThe most complete Godot 4 MCP: secure sandbox, 40+ tools (projects–runtime), major MCP clients.
1 stars
Reviews
Write oneNobody has reviewed Godot yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Godot tools (40, 8 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
godot_browse_githubSearch for Godot-related repositories on GitHub.
godot_check_versionCheck the Godot version.
godot_create_code_templatewrite actionCreate code from a template.
godot_create_projectwrite actionCreate a Godot project under the MCP workspace: writes project.godot and a starter .tscn (what the Project Manager also creates on disk). When run_godot_import is true and GODOT_MCP_ALLOW_GODOT_EXEC=1, runs the Godot editor in headless import mode (--import) so the .godot/ cache folder exists and resources are processed—this is the engine's own initialization step; there is no separate "create pro
godot_create_resourcewrite actionCreate a new resource file.
godot_create_scenewrite actionCreate a new scene file.
godot_create_scriptwrite actionCreate a new GDScript file.
godot_download_assetDownload an asset from the Asset Library.
godot_edit_fileEdit a Godot file by replacing content.
godot_execute_scriptwrite actionExecute a GDScript in the Godot project context.
godot_find_assetsFind assets by extension.
godot_find_by_patternFind files matching a pattern.
godot_find_godot_executableFind the Godot executable on the system.
godot_find_projectFind the Godot project root by searching for project.godot.
godot_find_unused_filesFind files that may not be referenced in scenes or scripts.
godot_generate_uidGenerate a unique ID for Godot resources.
godot_get_asset_infoGet detailed information about an asset.
godot_get_file_infoGet information about a file.
godot_get_logGet recent Godot log entries.
godot_get_node_infoGet information about a Godot node type.
godot_get_project_filesGet all files in the project.
godot_get_project_infoGet detailed information about the Godot project.
godot_get_project_settingsGet project settings from project.godot (read-only).
godot_get_workspaceReturn the sandbox directory for this server.
godot_list_autoloadList autoload singletons.
godot_list_editor_pluginsList addon folders with plugin.cfg and which editor plugins are enabled in project.godot.
godot_list_projectsList every Godot project under the MCP sandbox directory.
godot_list_resourcesList all .tres resource files in the Godot project.
godot_list_scenesList all .tscn scene files in the Godot project.
godot_list_scriptsList all .gd script files in the Godot project.
godot_read_sceneRead and parse a scene file.
godot_read_scriptRead and parse a GDScript file.
godot_refresh_projectRefresh project cache after file changes.
godot_run_gamewrite actionRun the Godot game.
godot_search_assetlibSearch the official Godot Asset Library.
godot_search_contentSearch for content in Godot files.
godot_validate_sceneValidate a scene file.
godot_validate_scriptValidate a GDScript file.
godot_watch_filesList scene, script, and/or resource files in the project (for monitoring or refresh).
godot_write_filewrite actionWrite content to a file.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan2 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 150 days ago8/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Godot compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 82/100
- higher than 63% of 48,255 servers
- Tools
- 40
- the typical server has 7
- Tools that change things
- 20%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 1
- more than 65% of 28,688 servers
What its tools let an agent do: 32 read · 8 change
Install Godot in Claude Code, Cursor or VS Code
claude mcp add godot -- uvx godot-mcp-server
What the publisher says
From the Godot repository's README, as published. We do not edit it. Read it on GitHub
Godot MCP Server
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.
<!-- mcp-name: io.github.sterion66/godot -->
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.
Code execution: godotrungame and godotexecutescript require GODOTMCPALLOWGODOTEXEC in the server environment. The shipped MCP JSON configs set it to 1 so these tools work after copy-paste. Running python godotmcpserver.py without that env still leaves execution off until you export it. To lock down an IDE install, remove the variable or set it to 0. See Godot execution (environment).
HTTP transport: Binding to 0.0.0.0 or :: exposes the MCP server on all network interfaces; prefer 127.0.0.1 unless you use a firewall or VPN.
Symlinks: GODOTMCPROOT is resolved with symlinks followed; point it at a real directory you control.
Features
Project Management
- Auto-detect Godot projects (project.godot); list all projects under the workspace (godotlistprojects)
- Create new projects under the workspace (godotcreateproject)
- Parse project settings and configuration; list autoloads and editor plugin state (read-only for plugins)
- Refresh project cache after changes
File Operations
- Read/write scenes (.tscn), scripts (.gd), resources (.tres)
- Create new scripts, scenes, resources from templates
- Edit existing files with content replacement
- Validate scene and script syntax
Code Generation
- CharacterBody2D/3D movement controllers
- State machine patterns
- Custom resources
- Node scripts with signals/exports
Asset Management
- Discover assets by extension, pattern, glob
- Find unused assets
- Search file contents with regex
- Search & download from Godot Asset Library
- Browse Godot repos on GitHub
Runtime Integration
- Find Godot executable
- Check Godot version
- Run game headless
- Execute GDScript code
- Read Godot logs
- File watcher configuration
Installation
# From PyPI-style editable install (recommended for contributors)
pip install -e .
# Or minimal deps only
pip install -r requirements.txtConsole entry point (after pip install -e .): godot-mcp-server (same as python godotmcpserver.py).
Workspace setup (required)
The MCP server only operates on Godot projects that live under one root folder. This keeps assistants from reading or writing arbitrary paths on your system.
- Create the default folder (once per machine):
mkdir -p ~/godot-games- Put every Godot game there — each game is its own subdirectory containing project.godot, for example:
~/godot-games/
my-platformer/ ← open this folder in your editor
project.godot
...
another-game/
project.godot- Open your IDE workspace inside ~/godot-games/.../your-game (or a parent folder under ~/godot-games) so the MCP process can discover project.godot from the current working directory.
- Custom location: Set an absolute path before starting the server:
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Godot: common questions
- Is Godot MCP server safe?
- Mostly: it is graded B (82/100). Read the Godot safety report
- How do I install Godot?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Godot need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Godot maintained?
- The last commit was 187 days ago (2026-05-01). The latest release is v1.0.2.
- How does Godot compare with other MCP servers?
- safety score 82/100 (higher than 63% of 48,255 servers); tools 40 (the typical server has 7); tools that change things 20% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.