google-surf-mcp
MCP server that stores Google search, papers, and code in a local knowledge graph.
Tested on Linux
Use it
Linux x86_64
You need first
- Runtimes:
Node.js >=22.12.0 - System packages:
Google Chrome or Chromium for browser mode - Keys or accounts: SearchApi key for optional primary/fallback search
install google-surf-mcp globally via npm
npm install -g google-surf-mcp
Check that it works
npx -y google-surf-mcp@latest hooks status --host codex 2>&1The output should contain “installed”.
First thing to try
npx -y google-surf-mcp@latest hooks status --host codex 2>&1Add it to your agent
claude mcp add google-surf-mcp -- google-surf-mcpJSON for Claude Desktop, Cursor and other clients
{
"mcpServers": {
"google-surf-mcp": {
"command": "google-surf-mcp",
"args": []
}
}
}Add npx -y google-surf-mcp@latest as an MCP server in your MCP client, then call the health tool to confirm it is running.
What it does
- Search the web, papers, and codeNot tested
- Extract text from HTML and PDF documentsNot tested
- Save results to project memoryNot shown working
- Analyze and export the local knowledge graphNot shown working
How far pickfit got
Linux x86_64
- Installs
- Connects
- 0 of 4 features work
- Needs the network
Good for
- Find new information on the web
- Run several new web queries
- Search only previously stored research and project memory
- Compare new web results with stored project knowledge
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
An MCP client called one of its tools
- Replayed from scratch
- Needed the network
- Checked on 31 Oct 2026
- Version 1.1.5
An MCP client handshake over stdio listed 7 tools, and a call to health returned a result.
Differences the test machine hit
- README: npx google-surf-mcp launches via npx
In the test: installed globally with npm install -g google-surf-mcp so binary is on PATH without network for replay - README: Chrome/Chromium required for browser mode
In the test: box has no Chrome; server starts and reports Chrome not found but still completes handshake and local tools work