NestDaddy
All servers NestDaddy MCP Blog Sign inTry it free
Search and web

Google Custom Search MCP

io.github.A1-x-Tech/mcp-google-custom-search · v1.1.1

MCP server for Google Custom Search: web and image search via a Programmable Search Engine.

Website Source code Set it up

Connect Runs on your machine

Terminal
claude mcp add mcp-google-custom-search -e GOOGLE_CUSTOM_SEARCH_API_KEY=<GOOGLE_CUSTOM_SEARCH_API_KEY> -e GOOGLE_CUSTOM_SEARCH_ENGINE_ID=<GOOGLE_CUSTOM_SEARCH_ENGINE_ID> -e GOOGLE_CUSTOM_SEARCH_API_BASE=<GOOGLE_CUSTOM_SEARCH_API_BASE> -e GOOGLE_CUSTOM_SEARCH_TIMEOUT_MS=<GOOGLE_CUSTOM_SEARCH_TIMEOUT_MS> -e GOOGLE_CUSTOM_SEARCH_MAX_RETRIES=<GOOGLE_CUSTOM_SEARCH_MAX_RETRIES> -- npx -y [email protected]
claude_desktop_config.json
{
  "mcpServers": {
    "mcp-google-custom-search": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "GOOGLE_CUSTOM_SEARCH_API_KEY": "<GOOGLE_CUSTOM_SEARCH_API_KEY>",
        "GOOGLE_CUSTOM_SEARCH_ENGINE_ID": "<GOOGLE_CUSTOM_SEARCH_ENGINE_ID>",
        "GOOGLE_CUSTOM_SEARCH_API_BASE": "<GOOGLE_CUSTOM_SEARCH_API_BASE>",
        "GOOGLE_CUSTOM_SEARCH_TIMEOUT_MS": "<GOOGLE_CUSTOM_SEARCH_TIMEOUT_MS>",
        "GOOGLE_CUSTOM_SEARCH_MAX_RETRIES": "<GOOGLE_CUSTOM_SEARCH_MAX_RETRIES>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "mcpServers": {
    "mcp-google-custom-search": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "GOOGLE_CUSTOM_SEARCH_API_KEY": "<GOOGLE_CUSTOM_SEARCH_API_KEY>",
        "GOOGLE_CUSTOM_SEARCH_ENGINE_ID": "<GOOGLE_CUSTOM_SEARCH_ENGINE_ID>",
        "GOOGLE_CUSTOM_SEARCH_API_BASE": "<GOOGLE_CUSTOM_SEARCH_API_BASE>",
        "GOOGLE_CUSTOM_SEARCH_TIMEOUT_MS": "<GOOGLE_CUSTOM_SEARCH_TIMEOUT_MS>",
        "GOOGLE_CUSTOM_SEARCH_MAX_RETRIES": "<GOOGLE_CUSTOM_SEARCH_MAX_RETRIES>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "mcp-google-custom-search": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "GOOGLE_CUSTOM_SEARCH_API_KEY": "<GOOGLE_CUSTOM_SEARCH_API_KEY>",
        "GOOGLE_CUSTOM_SEARCH_ENGINE_ID": "<GOOGLE_CUSTOM_SEARCH_ENGINE_ID>",
        "GOOGLE_CUSTOM_SEARCH_API_BASE": "<GOOGLE_CUSTOM_SEARCH_API_BASE>",
        "GOOGLE_CUSTOM_SEARCH_TIMEOUT_MS": "<GOOGLE_CUSTOM_SEARCH_TIMEOUT_MS>",
        "GOOGLE_CUSTOM_SEARCH_MAX_RETRIES": "<GOOGLE_CUSTOM_SEARCH_MAX_RETRIES>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

NameDescription
GOOGLE_CUSTOM_SEARCH_API_KEY
Required, secret		Google Cloud API key with the Custom Search API enabled. Treat it as a secret.
GOOGLE_CUSTOM_SEARCH_ENGINE_ID
Optional		Default Programmable Search Engine id (cx). Tools accept a per-call engine_id override.
GOOGLE_CUSTOM_SEARCH_API_BASE
Optional		API root override.
GOOGLE_CUSTOM_SEARCH_TIMEOUT_MS
Optional		Per-request timeout in milliseconds.
GOOGLE_CUSTOM_SEARCH_MAX_RETRIES
Optional		Retries on transient errors (429, and 5xx/network — the API is idempotent GETs only).

Details

Package[email protected] (NPM, stdio)
First published31 Oct 2026
Last updated31 Oct 2026
Registry nameio.github.A1-x-Tech/mcp-google-custom-search

More search and web servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.