MCP Directory

How to add Godot MCP to Windsurf

Let AI agents launch the Godot editor, run projects, capture debug output, and edit scenes. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

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

Windsurf 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 Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the Godot MCP config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5Godot MCP's tools become available to Cascade.

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 Windsurf

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 + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Godot MCP config there under the "mcpServers" key and restart the client.

Is Godot MCP safe to use with Windsurf?

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