Skip to content
MCP server

Google Custom Search MCP

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.1.1
Listing updated
4 days ago

About Google Custom Search MCP

Google Custom Search MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

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

Install

Run in a terminal

claude mcp add mcp-google-custom-search --env GOOGLE_CUSTOM_SEARCH_API_KEY='<GOOGLE_CUSTOM_SEARCH_API_KEY>' -- npx -y mcp-google-custom-search

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-google-custom-search": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-custom-search"
      ],
      "env": {
        "GOOGLE_CUSTOM_SEARCH_API_KEY": "<GOOGLE_CUSTOM_SEARCH_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-google-custom-search": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-custom-search"
      ],
      "env": {
        "GOOGLE_CUSTOM_SEARCH_API_KEY": "<GOOGLE_CUSTOM_SEARCH_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-google-custom-search": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-custom-search"
      ],
      "env": {
        "GOOGLE_CUSTOM_SEARCH_API_KEY": "<GOOGLE_CUSTOM_SEARCH_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-google-custom-search": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-custom-search"
      ],
      "env": {
        "GOOGLE_CUSTOM_SEARCH_API_KEY": "<GOOGLE_CUSTOM_SEARCH_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-google-custom-search": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-custom-search"
      ],
      "env": {
        "GOOGLE_CUSTOM_SEARCH_API_KEY": "<GOOGLE_CUSTOM_SEARCH_API_KEY>"
      }
    }
  }
}

Configuration

  • GOOGLE_CUSTOM_SEARCH_API_KEYGoogle Cloud API key with the Custom Search API enabled. Treat it as a secret.Required
  • GOOGLE_CUSTOM_SEARCH_ENGINE_IDDefault Programmable Search Engine id (cx). Tools accept a per-call engine_id override.
  • GOOGLE_CUSTOM_SEARCH_API_BASEAPI root override.
  • GOOGLE_CUSTOM_SEARCH_TIMEOUT_MSPer-request timeout in milliseconds.
  • GOOGLE_CUSTOM_SEARCH_MAX_RETRIESRetries on transient errors (429, and 5xx/network — the API is idempotent GETs only).

Pricing

Open source

Google Custom Search MCP FAQ

Is Google Custom Search MCP free?

Yes. Google Custom Search MCP is open source, so you can use and self-host it for free.

How do I add Google Custom Search MCP to Claude Code?

Run this command in your terminal: claude mcp add mcp-google-custom-search --env GOOGLE_CUSTOM_SEARCH_API_KEY='<GOOGLE_CUSTOM_SEARCH_API_KEY>' -- npx -y mcp-google-custom-search