google-surf-mcp
Rank #807io.github.HarimxChoi/google-surf-mcp
Web, academic and code search with graph RAG, data lineage, ontology and cross-project schema links.
google-surf-mcp is a Model Context Protocol (MCP) server published by harimxchoi. It ranks #807 of 115,707 servers tracked on MCP Toplist, and its repository has 285 GitHub stars. google-surf-mcp is listed across 4 registries — Official MCP, PulseMCP, mcp.so and Glama, with 10 tracked versions. It was first listed on Apr 30, 2026 and most recently updated on Aug 31, 2026.
Ranks ahead of 114,900 of 115,707 servers on MCP Toplist.
Use google-surf-mcp
No credentials or required configuration declared — add it to your MCP client and go.
claude mcp add google-surf-mcp -e "SEARCH_API=<your SEARCH_API>" -e "SURF_SEARCH_PROVIDER=<your SURF_SEARCH_PROVIDER>" -e "SURF_SCHOLAR_PROVIDER=<your SURF_SCHOLAR_PROVIDER>" -e "SURF_BROWSER_ENGINE=<your SURF_BROWSER_ENGINE>" -e "CHROME_PATH=<your CHROME_PATH>" -e "SURF_PROFILE_ROOT=<your SURF_PROFILE_ROOT>" -e "SURF_RESEARCH=<your SURF_RESEARCH>" -e "SURF_RETRIEVAL_MODE=<your SURF_RETRIEVAL_MODE>" -e "SURF_RESEARCH_ROOT=<your SURF_RESEARCH_ROOT>" -e "SURF_RESEARCH_VECTOR_MODEL=<your SURF_RESEARCH_VECTOR_MODEL>" -e "SURF_RESEARCH_REPO_AUTO=<your SURF_RESEARCH_REPO_AUTO>" -e "SURF_RESEARCH_REPO_AUTO_MAX_MB=<your SURF_RESEARCH_REPO_AUTO_MAX_MB>" -e "SURF_RESEARCH_REPO_AUTO_MAX_FILES=<your SURF_RESEARCH_REPO_AUTO_MAX_FILES>" -e "GITHUB_TOKEN=<your GITHUB_TOKEN>" -e "SURF_LOCALE=<your SURF_LOCALE>" -e "SURF_TZ=<your SURF_TZ>" -e "SURF_HEADLESS=<your SURF_HEADLESS>" -e "SURF_IDLE_CLOSE_MS=<your SURF_IDLE_CLOSE_MS>" -e "SURF_ALLOW_PRIVATE=<your SURF_ALLOW_PRIVATE>" -- npx -y google-surf-mcpReplace each placeholder with your own value before saving.
[mcp_servers.google-surf-mcp]
command = "npx"
args = ["-y", "google-surf-mcp"]
[mcp_servers.google-surf-mcp.env]
SEARCH_API = "<your SEARCH_API>"
SURF_SEARCH_PROVIDER = "<your SURF_SEARCH_PROVIDER>"
SURF_SCHOLAR_PROVIDER = "<your SURF_SCHOLAR_PROVIDER>"
SURF_BROWSER_ENGINE = "<your SURF_BROWSER_ENGINE>"
CHROME_PATH = "<your CHROME_PATH>"
SURF_PROFILE_ROOT = "<your SURF_PROFILE_ROOT>"
SURF_RESEARCH = "<your SURF_RESEARCH>"
SURF_RETRIEVAL_MODE = "<your SURF_RETRIEVAL_MODE>"
SURF_RESEARCH_ROOT = "<your SURF_RESEARCH_ROOT>"
SURF_RESEARCH_VECTOR_MODEL = "<your SURF_RESEARCH_VECTOR_MODEL>"
SURF_RESEARCH_REPO_AUTO = "<your SURF_RESEARCH_REPO_AUTO>"
SURF_RESEARCH_REPO_AUTO_MAX_MB = "<your SURF_RESEARCH_REPO_AUTO_MAX_MB>"
SURF_RESEARCH_REPO_AUTO_MAX_FILES = "<your SURF_RESEARCH_REPO_AUTO_MAX_FILES>"
GITHUB_TOKEN = "<your GITHUB_TOKEN>"
SURF_LOCALE = "<your SURF_LOCALE>"
SURF_TZ = "<your SURF_TZ>"
SURF_HEADLESS = "<your SURF_HEADLESS>"
SURF_IDLE_CLOSE_MS = "<your SURF_IDLE_CLOSE_MS>"
SURF_ALLOW_PRIVATE = "<your SURF_ALLOW_PRIVATE>"Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"google-surf-mcp": {
"command": "npx",
"args": [
"-y",
"google-surf-mcp"
],
"env": {
"SEARCH_API": "<your SEARCH_API>",
"SURF_SEARCH_PROVIDER": "<your SURF_SEARCH_PROVIDER>",
"SURF_SCHOLAR_PROVIDER": "<your SURF_SCHOLAR_PROVIDER>",
"SURF_BROWSER_ENGINE": "<your SURF_BROWSER_ENGINE>",
"CHROME_PATH": "<your CHROME_PATH>",
"SURF_PROFILE_ROOT": "<your SURF_PROFILE_ROOT>",
"SURF_RESEARCH": "<your SURF_RESEARCH>",
"SURF_RETRIEVAL_MODE": "<your SURF_RETRIEVAL_MODE>",
"SURF_RESEARCH_ROOT": "<your SURF_RESEARCH_ROOT>",
"SURF_RESEARCH_VECTOR_MODEL": "<your SURF_RESEARCH_VECTOR_MODEL>",
"SURF_RESEARCH_REPO_AUTO": "<your SURF_RESEARCH_REPO_AUTO>",
"SURF_RESEARCH_REPO_AUTO_MAX_MB": "<your SURF_RESEARCH_REPO_AUTO_MAX_MB>",
"SURF_RESEARCH_REPO_AUTO_MAX_FILES": "<your SURF_RESEARCH_REPO_AUTO_MAX_FILES>",
"GITHUB_TOKEN": "<your GITHUB_TOKEN>",
"SURF_LOCALE": "<your SURF_LOCALE>",
"SURF_TZ": "<your SURF_TZ>",
"SURF_HEADLESS": "<your SURF_HEADLESS>",
"SURF_IDLE_CLOSE_MS": "<your SURF_IDLE_CLOSE_MS>",
"SURF_ALLOW_PRIVATE": "<your SURF_ALLOW_PRIVATE>"
}
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.
{
"mcpServers": {
"google-surf-mcp": {
"command": "npx",
"args": [
"-y",
"google-surf-mcp"
],
"env": {
"SEARCH_API": "<your SEARCH_API>",
"SURF_SEARCH_PROVIDER": "<your SURF_SEARCH_PROVIDER>",
"SURF_SCHOLAR_PROVIDER": "<your SURF_SCHOLAR_PROVIDER>",
"SURF_BROWSER_ENGINE": "<your SURF_BROWSER_ENGINE>",
"CHROME_PATH": "<your CHROME_PATH>",
"SURF_PROFILE_ROOT": "<your SURF_PROFILE_ROOT>",
"SURF_RESEARCH": "<your SURF_RESEARCH>",
"SURF_RETRIEVAL_MODE": "<your SURF_RETRIEVAL_MODE>",
"SURF_RESEARCH_ROOT": "<your SURF_RESEARCH_ROOT>",
"SURF_RESEARCH_VECTOR_MODEL": "<your SURF_RESEARCH_VECTOR_MODEL>",
"SURF_RESEARCH_REPO_AUTO": "<your SURF_RESEARCH_REPO_AUTO>",
"SURF_RESEARCH_REPO_AUTO_MAX_MB": "<your SURF_RESEARCH_REPO_AUTO_MAX_MB>",
"SURF_RESEARCH_REPO_AUTO_MAX_FILES": "<your SURF_RESEARCH_REPO_AUTO_MAX_FILES>",
"GITHUB_TOKEN": "<your GITHUB_TOKEN>",
"SURF_LOCALE": "<your SURF_LOCALE>",
"SURF_TZ": "<your SURF_TZ>",
"SURF_HEADLESS": "<your SURF_HEADLESS>",
"SURF_IDLE_CLOSE_MS": "<your SURF_IDLE_CLOSE_MS>",
"SURF_ALLOW_PRIVATE": "<your SURF_ALLOW_PRIVATE>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.
{
"servers": {
"google-surf-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"google-surf-mcp"
],
"env": {
"SEARCH_API": "<your SEARCH_API>",
"SURF_SEARCH_PROVIDER": "<your SURF_SEARCH_PROVIDER>",
"SURF_SCHOLAR_PROVIDER": "<your SURF_SCHOLAR_PROVIDER>",
"SURF_BROWSER_ENGINE": "<your SURF_BROWSER_ENGINE>",
"CHROME_PATH": "<your CHROME_PATH>",
"SURF_PROFILE_ROOT": "<your SURF_PROFILE_ROOT>",
"SURF_RESEARCH": "<your SURF_RESEARCH>",
"SURF_RETRIEVAL_MODE": "<your SURF_RETRIEVAL_MODE>",
"SURF_RESEARCH_ROOT": "<your SURF_RESEARCH_ROOT>",
"SURF_RESEARCH_VECTOR_MODEL": "<your SURF_RESEARCH_VECTOR_MODEL>",
"SURF_RESEARCH_REPO_AUTO": "<your SURF_RESEARCH_REPO_AUTO>",
"SURF_RESEARCH_REPO_AUTO_MAX_MB": "<your SURF_RESEARCH_REPO_AUTO_MAX_MB>",
"SURF_RESEARCH_REPO_AUTO_MAX_FILES": "<your SURF_RESEARCH_REPO_AUTO_MAX_FILES>",
"GITHUB_TOKEN": "<your GITHUB_TOKEN>",
"SURF_LOCALE": "<your SURF_LOCALE>",
"SURF_TZ": "<your SURF_TZ>",
"SURF_HEADLESS": "<your SURF_HEADLESS>",
"SURF_IDLE_CLOSE_MS": "<your SURF_IDLE_CLOSE_MS>",
"SURF_ALLOW_PRIVATE": "<your SURF_ALLOW_PRIVATE>"
}
}
}
}Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"google-surf-mcp": {
"command": "npx",
"args": [
"-y",
"google-surf-mcp"
],
"env": {
"SEARCH_API": "<your SEARCH_API>",
"SURF_SEARCH_PROVIDER": "<your SURF_SEARCH_PROVIDER>",
"SURF_SCHOLAR_PROVIDER": "<your SURF_SCHOLAR_PROVIDER>",
"SURF_BROWSER_ENGINE": "<your SURF_BROWSER_ENGINE>",
"CHROME_PATH": "<your CHROME_PATH>",
"SURF_PROFILE_ROOT": "<your SURF_PROFILE_ROOT>",
"SURF_RESEARCH": "<your SURF_RESEARCH>",
"SURF_RETRIEVAL_MODE": "<your SURF_RETRIEVAL_MODE>",
"SURF_RESEARCH_ROOT": "<your SURF_RESEARCH_ROOT>",
"SURF_RESEARCH_VECTOR_MODEL": "<your SURF_RESEARCH_VECTOR_MODEL>",
"SURF_RESEARCH_REPO_AUTO": "<your SURF_RESEARCH_REPO_AUTO>",
"SURF_RESEARCH_REPO_AUTO_MAX_MB": "<your SURF_RESEARCH_REPO_AUTO_MAX_MB>",
"SURF_RESEARCH_REPO_AUTO_MAX_FILES": "<your SURF_RESEARCH_REPO_AUTO_MAX_FILES>",
"GITHUB_TOKEN": "<your GITHUB_TOKEN>",
"SURF_LOCALE": "<your SURF_LOCALE>",
"SURF_TZ": "<your SURF_TZ>",
"SURF_HEADLESS": "<your SURF_HEADLESS>",
"SURF_IDLE_CLOSE_MS": "<your SURF_IDLE_CLOSE_MS>",
"SURF_ALLOW_PRIVATE": "<your SURF_ALLOW_PRIVATE>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"google-surf-mcp": {
"command": "npx",
"args": [
"-y",
"google-surf-mcp"
],
"env": {
"SEARCH_API": "<your SEARCH_API>",
"SURF_SEARCH_PROVIDER": "<your SURF_SEARCH_PROVIDER>",
"SURF_SCHOLAR_PROVIDER": "<your SURF_SCHOLAR_PROVIDER>",
"SURF_BROWSER_ENGINE": "<your SURF_BROWSER_ENGINE>",
"CHROME_PATH": "<your CHROME_PATH>",
"SURF_PROFILE_ROOT": "<your SURF_PROFILE_ROOT>",
"SURF_RESEARCH": "<your SURF_RESEARCH>",
"SURF_RETRIEVAL_MODE": "<your SURF_RETRIEVAL_MODE>",
"SURF_RESEARCH_ROOT": "<your SURF_RESEARCH_ROOT>",
"SURF_RESEARCH_VECTOR_MODEL": "<your SURF_RESEARCH_VECTOR_MODEL>",
"SURF_RESEARCH_REPO_AUTO": "<your SURF_RESEARCH_REPO_AUTO>",
"SURF_RESEARCH_REPO_AUTO_MAX_MB": "<your SURF_RESEARCH_REPO_AUTO_MAX_MB>",
"SURF_RESEARCH_REPO_AUTO_MAX_FILES": "<your SURF_RESEARCH_REPO_AUTO_MAX_FILES>",
"GITHUB_TOKEN": "<your GITHUB_TOKEN>",
"SURF_LOCALE": "<your SURF_LOCALE>",
"SURF_TZ": "<your SURF_TZ>",
"SURF_HEADLESS": "<your SURF_HEADLESS>",
"SURF_IDLE_CLOSE_MS": "<your SURF_IDLE_CLOSE_MS>",
"SURF_ALLOW_PRIVATE": "<your SURF_ALLOW_PRIVATE>"
}
}
}
}Replace each placeholder with your own value before saving.
Show your rank
Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.
[](https://mcptoplist.com/server/io.github.HarimxChoi%2Fgoogle-surf-mcp)<a href="https://mcptoplist.com/server/io.github.HarimxChoi%2Fgoogle-surf-mcp"><img src="https://mcptoplist.com/badge/io.github.HarimxChoi%2Fgoogle-surf-mcp.svg" alt="MCP Toplist: Top 1% of 115,707" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
Listed on 1 registry (3 delisted)
harimxchoi
Available versions (10)
| Version | Published |
|---|---|
| 1.0.2 | Aug 31, 2026 |
| 1.0.1 | Aug 30, 2026 |
| 1.0.0 | Aug 28, 2026 |
| 0.9.8 | Aug 27, 2026 |
| 0.9.5 | Aug 26, 2026 |
| 0.4.6 | May 15, 2026 |
| 0.4.0 | May 2, 2026 |
| 0.3.1 | May 1, 2026 |
| 0.2.0 | May 1, 2026 |
| 0.1.1 | Apr 30, 2026 |
Frequently asked questions
- Who maintains google-surf-mcp?
- google-surf-mcp is maintained by harimxchoi, which publishes 1 MCP server (10 total versions) tracked on MCP Toplist.
- Is google-surf-mcp listed on the Official MCP Registry?
- Yes — google-surf-mcp is listed on the Official MCP Registry, alongside PulseMCP, mcp.so and Glama.
- How many versions does google-surf-mcp have?
- MCP Toplist tracks 10 versions of google-surf-mcp, most recently published on Aug 31, 2026.
- Where can I find the source code for google-surf-mcp?
- The source code for google-surf-mcp is hosted at github.com/harimxchoi/google-surf-mcp.