How do I install the godot forge mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `GODOT_PATH` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Godot Forge MCP Server

Godot 4 MCP server — test runner, API docs, script analysis, scene parsing, LSP.

Local serverstdioPython

What is the Godot Forge MCP Server?

Godot 4 MCP server — test runner, API docs, script analysis, scene parsing, LSP.

Configuration and credentials

Node.js 18+: for npx execution - Godot 4.x: auto-detected (optional for 6 of 8 tools) - Any MCP-compatible IDE: Claude Code, Cursor, VS Code, Windsurf, Zed, and more

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
godot_run_tests	Run GUT/GdUnit4 tests, get structured pass/fail results
godot_search_docs	Search Godot 4 API docs with 3→4 migration mapping
godot_analyze_script	Detect 10 GDScript pitfalls (deprecated API, coupling, re-entrancy)
godot_analyze_scene	Parse .tscn/.tres, detect antipatterns and format errors
godot_get_project_info	Project structure overview with progressive disclosure
godot_get_diagnostics	LSP diagnostics from Godot's language server
godot_run_project	Launch/stop project, capture debug output
godot_screenshot	Capture viewport screenshot as base64 PNG

How to install the Godot Forge MCP Server

{
  "mcpServers": {
    "godot-forge": {
      "command": "npx",
      "args": ["-y", "godot-forge"],
      "env": {
        "GODOT_PATH": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

Node.js 18+: for npx execution - Godot 4.x: auto-detected (optional for 6 of 8 tools) - Any MCP-compatible IDE: Claude Code, Cursor, VS Code, Windsurf, Zed, and more

Variable	Description	Required
GODOT_PATH	Filesystem location the server is allowed to use.	Optional

Example prompts to try

“Use Godot Forge to godot run tests.”
“Use Godot Forge to godot search docs.”
“Use Godot Forge to godot analyze script.”

Frequently asked questions

Godot 4 MCP server — test runner, API docs, script analysis, scene parsing, LSP. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.