gemini-search
Provides web search via Google Search using Gemini grounding, returning a summarized answer with inline citations and a list of source URLs.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@gemini-search search the web for the latest news on the James Webb telescope"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
gemini-search-mcp
An MCP server that lets AI assistants search the web with Google Search via Gemini grounding. It returns a summarized answer with inline citations ([1], [2,3]) and a list of source URLs.
Inspired by yukukotani/mcp-gemini-google-search, rewritten with these fixes:
Citation markers are placed using UTF-8 byte offsets (as Gemini reports them), so they land correctly in Chinese / Japanese / emoji text.
Missing credentials are reported as a tool error instead of crashing the server at startup.
Requests have a timeout and honor MCP cancellation.
Errors are returned as
isErrortool results so the model can see and react to them.
Tool
google_search
Param | Type | Description |
| string (required) | The search query or question. |
Related MCP server: Deno Gemini Grounding MCP Server
Usage
Requires Node.js >= 20.
Installed directly from GitHub (built automatically on install via prepare):
{
"mcpServers": {
"gemini-search": {
"command": "npx",
"args": ["-y", "github:spotmaxtech/gemini-search-mcp"],
"env": {
"GEMINI_API_KEY": "your-api-key"
}
}
}
}Pin a version with a tag or commit, e.g. github:spotmaxtech/gemini-search-mcp#v0.1.0.
Claude Code:
claude mcp add gemini-search -e GEMINI_API_KEY=your-api-key -- npx -y github:spotmaxtech/gemini-search-mcpConfiguration
Variable | Default | Description |
| - | Google AI Studio API key. Required unless using Vertex AI. |
| - | Set to |
| - | GCP project ID. Required when |
|
| Vertex AI location. |
|
| Gemini model to use. |
|
| Request timeout in milliseconds. |
|
| Replace Google grounding redirect links with the real page URLs (reads only the redirect header, 3s timeout per link). Set to |
Vertex AI uses Application Default Credentials (e.g. gcloud auth application-default login).
Development
npm install # also builds via prepare
npm test # unit tests
npm run typecheck
npm run build
GEMINI_API_KEY=... npm run inspect # open MCP InspectorThe Inspector does not pass your shell environment to the server process; npm run inspect forwards the variables above explicitly via -e.
License
MIT
Available Tools
1 toolgoogle_searchGoogle SearchARead-only
Searches the web with Google Search (via Gemini grounding) and returns a summarized answer with inline citations [n] and a list of source URLs. Use it for up-to-date information or facts not in your training data.
Inputs: query (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
There is only one tool, so there is no possibility of misselection between tools. Its purpose (web search with summarized answers and citations) is stated unambiguously.
The single name google_search is a clear, lowercase snake_case noun-qualified action name with no competing conventions to clash with. There is nothing inconsistent to evaluate.
One tool is thin compared to the typical 3-15 range, but it exactly matches the server's narrow, single-purpose scope (Gemini-grounded Google search), so nothing is bloat or missing at the count level.
The search-and-summarize workflow is fully covered with inline citations and source URLs, which is the whole stated domain. Minor gaps exist (no way to fetch/open a full page for deeper reading, no query options like date range or news/image scopes) that an agent could work around by re-searching.
Maintenance
Related MCP Connectors
Provides AI assistants with access to Seltz's powerful Web Search capabilities.
Google search, news, maps, webpages, cited answers, research and ChatGPT/Gemini answers for agents.
Search Google straight from your AI agent. Web results, images, videos, news, products, scholarly ar
Web search, Google SERP, page extraction to markdown and cited answers for AI agents.
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides Google Search functionality for AI models using Gemini's built-in Grounding with Google Search feature, returning real-time web search results with source citations.183Apache 2.0
- AlicenseNot gradedqualityDmaintenanceProvides Google search grounding capabilities for Gemini AI models through MCP, enabling AI assistants to perform web searches with Gemini's grounding API for more accurate and up-to-date responses.MIT
- AlicenseNot gradedqualityDmaintenanceEnables web search using Google Gemini with search grounding and question-answering on local documents, with support for chunked document reading.117 npm63 PyPI1MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI tools to perform real-time Google Search with grounded answers and inline citations, free with a Google account.4MIT