Google Custom Search MCP server
{
"mcpServers": {
"a1-x-tech-google-custom-search": {
"command": "npx",
"args": [
"-y",
"mcp-google-custom-search@latest"
],
"env": {
"GOOGLE_CUSTOM_SEARCH_API_KEY": "<google_custom_search_api_key>",
"GOOGLE_CUSTOM_SEARCH_ENGINE_ID": "<google_custom_search_engine_id>"
}
}
}
}{
"mcpServers": {
"a1-x-tech-google-custom-search": {
"command": "npx",
"args": [
"-y",
"mcp-google-custom-search@latest"
],
"env": {
"GOOGLE_CUSTOM_SEARCH_API_KEY": "<google_custom_search_api_key>",
"GOOGLE_CUSTOM_SEARCH_ENGINE_ID": "<google_custom_search_engine_id>"
}
}
}
}{
"mcpServers": {
"a1-x-tech-google-custom-search": {
"command": "npx",
"args": [
"-y",
"mcp-google-custom-search@latest"
],
"env": {
"GOOGLE_CUSTOM_SEARCH_API_KEY": "<google_custom_search_api_key>",
"GOOGLE_CUSTOM_SEARCH_ENGINE_ID": "<google_custom_search_engine_id>"
}
}
}
}{
"servers": {
"a1-x-tech-google-custom-search": {
"command": "npx",
"args": [
"-y",
"mcp-google-custom-search@latest"
],
"env": {
"GOOGLE_CUSTOM_SEARCH_API_KEY": "${input:google_custom_search_api_key}",
"GOOGLE_CUSTOM_SEARCH_ENGINE_ID": "${input:google_custom_search_engine_id}"
}
}
},
"inputs": [
{
"id": "google_custom_search_api_key",
"type": "promptString",
"description": "Google custom search api key",
"password": true
},
{
"id": "google_custom_search_engine_id",
"type": "promptString",
"description": "Google custom search engine id",
"password": true
}
]
}{
"mcpServers": {
"a1-x-tech-google-custom-search": {
"command": "npx",
"args": [
"-y",
"mcp-google-custom-search@latest"
],
"env": {
"GOOGLE_CUSTOM_SEARCH_API_KEY": "<google_custom_search_api_key>",
"GOOGLE_CUSTOM_SEARCH_ENGINE_ID": "<google_custom_search_engine_id>"
}
}
}
}file .mcp.json (in your project root)file claude_desktop_config.jsonfile ~/.cursor/mcp.jsonfile .vscode/mcp.jsonfile ~/.codeium/windsurf/mcp_config.jsoninstall npx -y mcp-google-custom-searchversion 0.1.0
What it does
MCP server for web and image search through Google's Programmable Search Engine using the Custom Search JSON API. For developers who need to integrate search functionality controlled by a custom search configuration rather than general web search.
- Search for recent articles on a topic with filters for language, country, date range and specific sites, then retrieve paginated results.
- Find images related to a query and get image files with thumbnails and the pages that host them.
- Query a custom search engine covering a limited set of sites or the entire web as configured in your Programmable Search Engine settings.
Tools this server exposes
| Tool | Does |
|---|---|
| web_search | Search the web through your Programmable Search Engine with support for filtering by language, country, date, and specific sites. |
| image_search | Search for images through your Programmable Search Engine and retrieve image files with dimensions and thumbnails. |
| raw_get | Send raw GET requests to the Custom Search API for parameters not exposed by the typed tools. |
Before you enable it
An MCP server runs with whatever access you give it. Start with a development account rather than production, and check which tools the server exposes before you let an agent call them unattended.