Install google-surf-mcp for Claude Desktop
Claude Desktop reads mcpServers from claude_desktop_config.json. Restart the app after saving.
- Open ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows, or ~/.config/Claude/claude_desktop_config.json on Linux.
- Paste the JSON config below.
- Replace placeholder secrets, then restart the client if it does not reload on its own.
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"harimxchoi-google-surf-mcp": {
"command": "npx",
"args": [
"-y",
"google-surf-mcp@1.1.3"
],
"env": {
"SEARCH_API": "YOUR_SEARCH_API",
"SURF_SEARCH_PROVIDER": "",
"SURF_SCHOLAR_PROVIDER": "",
"SURF_BROWSER_ENGINE": "",
"CHROME_PATH": "",
"SURF_PROFILE_ROOT": "",
"SURF_RESEARCH": "",
"SURF_RETRIEVAL_MODE": "",
"SURF_RESEARCH_ROOT": "",
"SURF_RESEARCH_VECTOR_MODEL": "",
"SURF_RESEARCH_VECTOR_LOW_MEMORY": "",
"SURF_RESEARCH_VECTOR_THREADS": "",
"SURF_RESEARCH_REPO_AUTO": "",
"SURF_RESEARCH_REPO_AUTO_MAX_MB": "",
"SURF_RESEARCH_REPO_AUTO_MAX_FILES": "",
"SURF_RESEARCH_BROKER_IDLE_MS": "",
"SURF_RESEARCH_READ_CONCURRENCY": "",
"SURF_RESEARCH_QUERY_TIMEOUT_MS": "",
"GITHUB_TOKEN": "YOUR_GITHUB_TOKEN",
"SURF_LOCALE": "",
"SURF_TZ": "",
"SURF_HEADLESS": "",
"SURF_IDLE_CLOSE_MS": "",
"SURF_ALLOW_PRIVATE": "",
"SURF_LLM_HEAL": "",
"SURF_LLM_PROVIDER": "",
"SURF_LLM_MODEL": "",
"ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY",
"ORCAROUTER_API_KEY": "YOUR_ORCAROUTER_API_KEY"
}
}
}
}