Skip to content
MCP server

GodotLens

Godot's own view of your GDScript project: code, scenes, and the running game

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.2.0
Listing updated
6 days ago

About GodotLens

GodotLens is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add godotlens -- npx -y godotlens-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "godotlens": {
      "command": "npx",
      "args": [
        "-y",
        "godotlens-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "godotlens": {
      "command": "npx",
      "args": [
        "-y",
        "godotlens-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "godotlens": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "godotlens-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "godotlens": {
      "command": "npx",
      "args": [
        "-y",
        "godotlens-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "godotlens": {
      "command": "npx",
      "args": [
        "-y",
        "godotlens-mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • GODOT_LSP_HOSTGodot language server host
  • GODOT_LSP_PORTGodot language server port (the VS Code extension uses 6008)
  • GODOT_DAP_HOSTGodot debug adapter host
  • GODOT_DAP_PORTGodot debug adapter port, used by the debug_* tools
  • GODOT_BINGodot executable, required by scene_*, project_config and runtime_*
  • GODOT_PROJECT_ROOTProject root; auto-detected by walking up for project.godot
  • GODOT_LSP_TIMEOUTSeconds to wait for a single LSP response
  • GODOT_DIAGNOSTICS_TIMEOUTSeconds to wait for diagnostics after a sync
  • GODOT_VERSIONOverride Godot capability detection
  • GODOT_FIND_FILE_LIMITMax files gdscript_find inspects across the project
  • GODOT_RUNTIME_MAX_SESSIONSMax games runtime_run keeps running at once
  • GODOT_LSP_HOSTGodot language server host
  • GODOT_LSP_PORTGodot language server port (the VS Code extension uses 6008)
  • GODOT_DAP_HOSTGodot debug adapter host
  • GODOT_DAP_PORTGodot debug adapter port, used by the debug_* tools
  • GODOT_BINGodot executable, required by scene_*, project_config and runtime_*
  • GODOT_PROJECT_ROOTProject root; auto-detected by walking up for project.godot
  • GODOT_LSP_TIMEOUTSeconds to wait for a single LSP response
  • GODOT_DIAGNOSTICS_TIMEOUTSeconds to wait for diagnostics after a sync
  • GODOT_VERSIONOverride Godot capability detection
  • GODOT_FIND_FILE_LIMITMax files gdscript_find inspects across the project
  • GODOT_RUNTIME_MAX_SESSIONSMax games runtime_run keeps running at once

Pricing

Open source

GodotLens FAQ

Is GodotLens free?

Yes. GodotLens is open source, so you can use and self-host it for free.

How do I add GodotLens to Claude Code?

Run this command in your terminal: claude mcp add godotlens -- npx -y godotlens-mcp

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers