Turn Google Search, Papers, and Codebases into an Automatic Local Knowledge Graph for AI Agents.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add google-surf --env SEARCH_API='<SEARCH_API>' --env GITHUB_TOKEN='<GITHUB_TOKEN>' --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' --env ORCAROUTER_API_KEY='<ORCAROUTER_API_KEY>' -- npx -y google-surf-mcp~/.codex/config.toml
[mcp_servers.google-surf]
command = "npx"
args = ["-y", "google-surf-mcp"]
env = { SEARCH_API = "<SEARCH_API>", GITHUB_TOKEN = "<GITHUB_TOKEN>", ANTHROPIC_API_KEY = "<ANTHROPIC_API_KEY>", ORCAROUTER_API_KEY = "<ORCAROUTER_API_KEY>" }
# codex mcp add google-surf --env SEARCH_API='<SEARCH_API>' --env GITHUB_TOKEN='<GITHUB_TOKEN>' --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' --env ORCAROUTER_API_KEY='<ORCAROUTER_API_KEY>' -- npx -y google-surf-mcp~/.cursor/mcp.json
{
"mcpServers": {
"google-surf": {
"command": "npx",
"args": [
"-y",
"google-surf-mcp"
],
"env": {
"SEARCH_API": "<SEARCH_API>",
"GITHUB_TOKEN": "<GITHUB_TOKEN>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"ORCAROUTER_API_KEY": "<ORCAROUTER_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"google-surf": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"google-surf-mcp"
],
"env": {
"SEARCH_API": "<SEARCH_API>",
"GITHUB_TOKEN": "<GITHUB_TOKEN>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"ORCAROUTER_API_KEY": "<ORCAROUTER_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"google-surf": {
"command": "npx",
"args": [
"-y",
"google-surf-mcp"
],
"env": {
"SEARCH_API": "<SEARCH_API>",
"GITHUB_TOKEN": "<GITHUB_TOKEN>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"ORCAROUTER_API_KEY": "<ORCAROUTER_API_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"google-surf": {
"command": "npx",
"args": [
"-y",
"google-surf-mcp"
],
"env": {
"SEARCH_API": "<SEARCH_API>",
"GITHUB_TOKEN": "<GITHUB_TOKEN>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"ORCAROUTER_API_KEY": "<ORCAROUTER_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"google-surf": {
"command": "npx",
"args": [
"-y",
"google-surf-mcp"
],
"env": {
"SEARCH_API": "<SEARCH_API>",
"GITHUB_TOKEN": "<GITHUB_TOKEN>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"ORCAROUTER_API_KEY": "<ORCAROUTER_API_KEY>"
}
}
}
}Environment variables
SEARCH_APIGITHUB_TOKENANTHROPIC_API_KEYORCAROUTER_API_KEY
Replace the placeholders with your own credentials and keep them out of version control.