Advertise
MCP.so
Sign In

Google Custom Search MCP Server

@fbettag

Repository

Basic information

Category

Search

Last updated

Transports

stdio

Author

fbettag

Submitted by

Franz Bettag

About Google Custom Search MCP Server

No overview available yet

#google-custom-search#api#python-server

Google Custom Search MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "google-search": {
      "command": "uv",
      "args": [
        "run",
        "path/to/your/clone/of/google-custom-search-mcp"
      ],
      "env": {
        "GOOGLE_SERVICE_ACCOUNT_FILE": "/path/to/your/service-account-key.json",
        "GOOGLE_SEARCH_ENGINE_ID": "your-search-engine-id"
      }
    }
  }
}

Google Custom Search MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Google Custom Search MCP?

Google Custom Search MCP is an async Python MCP (Model Context Protocol) server that provides access to Google Custom Search API using service account authentication. It is designed for developers and AI assistants that need to perform Google Custom Search queries programmatically through the MCP protocol.

How to use Google Custom Search MCP?

Clone the repository, configure a Google Service Account and Custom Search Engine, then run uv run google-custom-search-mcp with the required environment variables GOOGLE_SERVICE_ACCOUNT_FILE or GOOGLE_SERVICE_ACCOUNT_BASE64 and GOOGLE_SEARCH_ENGINE_ID. The server supports STDIO mode (default) and HTTP mode (via --transport http). Docker and Helm deployments are available.

Key features of Google Custom Search MCP

  • Perform Google Custom Search queries with configurable result count
  • Service Account authentication (file path or base64)
  • Live integration tests against actual Google API
  • FastMCP Python SDK integration
  • Docker support with Alpine Linux image
  • UV compatibility for modern Python packaging

Use cases of Google Custom Search MCP

  • Building AI assistants that need real-time web search results
  • Enabling MCP clients to query Google Custom Search inside workflows
  • Integrating custom search into CI/CD pipelines with base64 auth
  • Deploying a custom search microservice on Kubernetes

Frequently asked questions

1

What is required to use Google Custom Search MCP?

You need a Google Cloud project with the Custom Search API enabled, a service account with a JSON key, and a Custom Search Engine ID. Environment variables authenticate the service account.

2

How does authentication work?

Authentication uses a Google Service Account, either via a file path (local development) or a base64-encoded JSON string (CI/CD). API keys are deprecated.

3

What are the API limits?

The Google Custom Search API provides 100 free search queries per day. Additional queries require billing setup. Service accounts have the

Comments

More Search MCP servers

A

AssistAnt 24/7

tnappliancerepair-hub

The most AI-friendly business directory. A tool AIs call, not a website AIs scrape. A free directory of 810,000+ local U.S. businesses in 39 trades, built for AI assistants. AIs come here to find businesses they can trus

Google Search MCP Server

HasData

Hosted Google Search / SERP MCP server from HasData, no Google Cloud project. Organic results, AI Overview, People Also Ask, AI Mode, news and shopping for Claude, Cursor and any MCP client.

23
S

SlickTrip

Slicktrip LLC

Live flight, hotel and seat prices for AI assistants. Search fares and hotel rates, find the cheapest days on a calendar, check open seats on a flight, and set price-drop, seat and bucket-list alerts.

Free SEO Audit for Claude

houtini.com

Free SEO Audit MCP server for Claude - captures and stores all the raw data you need for a complete technical SEO audit. Google Search Console + a first-party crawl + DataForSEO + Majestic SEO merged into one prioritised

86

Theyond

theyond

If it's here, it's on their board. Search live verified jobs from employer career pages.

Advertise