Installation

Prerequisites

Before installing GodotIQ, ensure you have:

Python 3.10+ — python.org/downloads
Godot 4.2+ — godotengine.org
An MCP-compatible AI client — Claude Code, Cursor, Windsurf, VSCode Copilot, or any MCP client

Install GodotIQ

Install via pip:
Terminal window
```
pip install godotiq
```
This installs the Community edition with 15 free tools — spatial intelligence, code understanding, flow tracing, project memory, asset management, and animation analysis. No Godot addon required.
Configure your MCP client (see below).
Verify the connection by asking your AI to use the godotiq_ping tool, or simply ask: “Ping GodotIQ” — it should confirm the server is running.

Configure Your MCP Client

Run this command in your terminal:

claude mcp add godotiq -- godotiq --project /path/to/your/godot/project

Claude Code manages MCP servers via its CLI. Replace /path/to/your/godot/project with the absolute path to your Godot project root (the directory containing project.godot).

Create .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "godotiq": {
      "command": "godotiq",
      "args": ["--project", "/path/to/your/godot/project"]
    }
  }
}

Restart Cursor after saving. The MCP server will start automatically when Cursor opens the project.

Add GodotIQ to your Windsurf MCP configuration (~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "godotiq": {
      "command": "godotiq",
      "args": ["--project", "/path/to/your/godot/project"]
    }
  }
}

Restart Windsurf to activate.

Add to your VSCode settings (.vscode/settings.json):

{
  "mcp": {
    "servers": {
      "godotiq": {
        "command": "godotiq",
        "args": ["--project", "/path/to/your/godot/project"]
      }
    }
  }
}

VSCode Copilot will detect the MCP server on next activation.

Alternative: Instead of the --project flag, you can set the GODOTIQ_PROJECT_ROOT environment variable in your MCP configuration. This is useful when using uv to run GodotIQ:

{
  "mcpServers": {
    "godotiq": {
      "command": "uv",
      "args": ["run", "--project", "/path/to/godotiq", "godotiq"],
      "env": {
        "GODOTIQ_PROJECT_ROOT": "/path/to/your/godot/project"
      }
    }
  }
}

Next Steps

Quickstart Try five prompts to explore your Godot project with AI.

Configuration Customize GodotIQ behavior with .godotiq.json.