MCP Directory

How to add Godot MCP to Claude Desktop

Let AI agents launch the Godot editor, run projects, capture debug output, and edit scenes. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 4.4k★ · stdio · no auth

Claude Desktop config for Godot MCP

claude mcp add godot -- npx @coding-solo/godot-mcp
{
  "mcpServers": {
    "godot-mcp": {
      "command": "npx",
      "args": [
        "@coding-solo/godot-mcp"
      ],
      "env": {
        "GODOT_PATH": "/path/to/godot",
        "DEBUG": "true"
      }
    }
  }
}

Setup steps

  1. 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
  2. 2Paste the Godot MCP config below under the top-level "mcpServers" key.
  3. 3Fill in any placeholder secrets (API keys, paths) in the snippet.
  4. 4Save the file, then fully quit and reopen Claude Desktop.
  5. 5Open a chat and confirm Godot MCP's tools appear under the 🔌 tools menu.

Before you start

  • Godot Engine installed on your system
  • Node.js (>=18.0.0) and npm
  • An AI agent / MCP client that supports MCP
  • Optionally set GODOT_PATH if the Godot executable is not auto-detected

What Godot MCP can do in Claude Desktop

launch_editor

Launch the Godot editor for a specific project.

run_project

Execute a Godot project in debug mode.

get_debug_output

Retrieve console output and error messages from the running project.

stop_project

Stop a running Godot project.

get_godot_version

Retrieve the installed Godot version.

list_projects

Find Godot projects in a specified directory.

get_project_info

Get detailed information about a project's structure.

create_scene

Create a new scene with a specified root node type.

Security

Runs locally over stdio with no authentication. It can launch the Godot editor and execute Godot projects on your machine, so only use it with projects you trust. The Godot Engine must be installed; set GODOT_PATH if it cannot be auto-detected.

Godot MCP + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Godot MCP config there under the "mcpServers" key and restart the client.

Is Godot MCP safe to use with Claude Desktop?

Runs locally over stdio with no authentication. It can launch the Godot editor and execute Godot projects on your machine, so only use it with projects you trust. The Godot Engine must be installed; set GODOT_PATH if it cannot be auto-detected.

Do I need Godot installed separately?

Yes. The Godot Engine must be installed on your system. If the server can't auto-detect it, set the GODOT_PATH environment variable to your Godot executable path.

Which MCP clients are supported?

Any MCP-compatible client. The README gives explicit setup for Claude Code (`claude mcp add godot -- npx @coding-solo/godot-mcp`), Cline, and Cursor, plus a generic mcpServers JSON config for other clients.

How does it handle complex operations like creating scenes?

Simple operations use Godot's built-in CLI directly. Complex operations run through a single bundled GDScript file (godot_operations.gd) that accepts the operation type and parameters as JSON, avoiding per-operation temporary files.

View repo Full Godot MCP page