google-surf-mcp
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 vars
CHROME_PATH SURF_PROFILE_ROOT SURF_LOCALE SURF_TZ SURF_HEADLESS SURF_IDLE_CLOSE_MS SURF_ALLOW_PRIVATEClaude 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
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.