Google Custom Search MCP
MCP server for Google Custom Search: web and image search via a Programmable Search…
- 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-searchAdd 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.RequiredGOOGLE_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