← Back to browse

google-surf-mcp

Indexed by io.github.HarimxChoi

About

Google search via Playwright with a warm Chrome profile. No API key, no proxies.

Use this server

Add it to your MCP client. The catalogue lists this config verbatim from its source — it does not run, download, or vouch for the server. Review the command before you run it.

Transportstdio (runs a local command)
Env varsCHROME_PATH SURF_PROFILE_ROOT SURF_LOCALE SURF_TZ SURF_HEADLESS SURF_IDLE_CLOSE_MS SURF_ALLOW_PRIVATE
Claude Code
claude mcp add --env CHROME_PATH= --env SURF_PROFILE_ROOT= --env SURF_LOCALE= --env SURF_TZ= --env SURF_HEADLESS= --env SURF_IDLE_CLOSE_MS= --env SURF_ALLOW_PRIVATE= google-surf-mcp -- npx google-surf-mcp
Cursor

Add to Cursor

If the button doesn't open Cursor, use the JSON below — Cursor accepts the same mcpServers config.

VS Code
code --add-mcp '{"name":"google-surf-mcp","command":"npx","args":["google-surf-mcp"],"env":{"CHROME_PATH":"","SURF_PROFILE_ROOT":"","SURF_LOCALE":"","SURF_TZ":"","SURF_HEADLESS":"","SURF_IDLE_CLOSE_MS":"","SURF_ALLOW_PRIVATE":""}}'
JSON
{
  "mcpServers": {
    "google-surf-mcp": {
      "command": "npx",
      "args": [
        "google-surf-mcp"
      ],
      "env": {
        "CHROME_PATH": "",
        "SURF_PROFILE_ROOT": "",
        "SURF_LOCALE": "",
        "SURF_TZ": "",
        "SURF_HEADLESS": "",
        "SURF_IDLE_CLOSE_MS": "",
        "SURF_ALLOW_PRIVATE": ""
      }
    }
  }
}

Environment variables are listed by name only — fill in your own values. Entries never carry secrets.