MCP Directory

How to add Godot MCP to Cursor

Let AI agents launch the Godot editor, run projects, capture debug output, and edit scenes. Paste the config into ~/.cursor/mcp.json and restart Cursor.

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

Cursor 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 Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
  2. 2Paste the Godot MCP config below into the "mcpServers" object.
  3. 3Fill in placeholder secrets, then save.
  4. 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
  5. 5Ask Cursor to use one of Godot MCP's tools to confirm it's connected.

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 Cursor

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

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the Godot MCP config there under the "mcpServers" key and restart the client.

Is Godot MCP safe to use with Cursor?

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