Skip to content
mcp/harbor
Gemini CLI

CloakBrowser MCP for Gemini CLI

io.github.swimmwatch/cloakbrowser-mcp

Playwright MCP-compatible browser automation bridge for CloakBrowser Chromium.

client:Gemini CLI transport:stdio runtime:npm

Install CloakBrowser MCP in Gemini CLI

~/.gemini/settings.json · windows: %USERPROFILE%\.gemini\settings.json

Held in this page only — never stored, logged, or sent anywhere but back to your screen. 

{
  "mcpServers": {
    "cloakbrowser-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cloakbrowser-mcp"
      ],
      "env": {
        "PLAYWRIGHT_MCP_BROWSER_ENGINE": "<PLAYWRIGHT_MCP_BROWSER_ENGINE>",
        "PLAYWRIGHT_MCP_HEADLESS": "<PLAYWRIGHT_MCP_HEADLESS>",
        "PLAYWRIGHT_MCP_OUTPUT_DIR": "<PLAYWRIGHT_MCP_OUTPUT_DIR>",
        "PLAYWRIGHT_MCP_CODEGEN": "<PLAYWRIGHT_MCP_CODEGEN>",
        "PLAYWRIGHT_MCP_SNAPSHOT_BOXES": "<PLAYWRIGHT_MCP_SNAPSHOT_BOXES>",
        "PLAYWRIGHT_MCP_TIMEOUT_SETTLE": "<PLAYWRIGHT_MCP_TIMEOUT_SETTLE>",
        "PLAYWRIGHT_MCP_USER_DATA_DIR": "<PLAYWRIGHT_MCP_USER_DATA_DIR>",
        "CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONS": "<CLOAK_PLAYWRIGHT_MCP_CONTEXT_OPTIONS>",
        "CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHS": "<CLOAK_PLAYWRIGHT_MCP_EXTENSION_PATHS>",
        "CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK": "<CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK>",
        "CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH": "<CLOAK_PLAYWRIGHT_MCP_GEOIP_PROXY_MATCH>",
        "CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS": "<CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS>"
      }
    }
  }
}

Gemini expands $VAR and ${VAR} inside env values, so a secret can live in your shell rather than this file. Gemini CLI docs

CloakBrowser MCP in other clients

CloakBrowser MCP MCP server