← Back to GodotIQ

Install GodotIQ

Pick your client, copy the command, done.

1

Add it to Claude Code

claude mcp add -e "GODOTIQ_PROJECT_ROOT=${GODOTIQ_PROJECT_ROOT}" godotiq -- uvx godotiq
Required:GODOTIQ_PROJECT_ROOT

Environment Variables

Set these before running GodotIQ.

VariableDescriptionRequired
GODOTIQ_PROJECT_ROOTThe absolute path to the Godot project directory.Yes

Available Tools (6)

Once configured, GodotIQ gives your AI agent access to:

screenshotCaptures a screenshot of the editor viewport.
scene_mapMaps the 3D scene structure for spatial awareness.
placementIntelligently places objects in the scene using Marker3D slots or grid search.
trace_flowTraces signal flow across multiple files to identify failure points.
ui_mapMaps UI elements with screen positions and touch target validation.
validateChecks and auto-fixes GDScript conventions.

Try It Out

After setup, try these prompts with your AI agent:

Move the player character to the nearest empty Marker3D slot in the current scene.
Trace the signal flow for the 'accept_order' event and identify any potential failure points.
Map the UI elements in the main menu and validate that all buttons have valid touch targets.
Validate the GDScript files in the player folder for project conventions.
Take a screenshot of the current editor viewport to verify the recent object placement.
Prerequisites & system requirements
  • An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
  • Python 3.8+ with pip installed
  • GODOTIQ_PROJECT_ROOT — The absolute path to the Godot project directory.
Alternative installation methods

Addon Install

godotiq install-addon /path/to/your/godot/project
Conare · memory for coding agents

Keep this setup from going cold

Save the docs, env vars, and workflow around GodotIQ in Conare so Claude Code, Codex, and Cursor remember it next time.

Remember this setup$npx conare@latest