explaingit

sophomoresty/gemini-search-mcp

Analysis updated 2026-05-18

160PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

A free MCP server that gives AI assistants unlimited real-time web search by driving a real Chrome tab through Google's AI Mode.

Mindmap

mindmap
  root((gemini-search-mcp))
    What it does
      Free unlimited web search
      Uses Google AI Mode
      MCP server for AI agents
    Tech stack
      Python
      MCP protocol
      Chrome DevTools Protocol
    Use cases
      Real time answers in chat
      Local OpenAI compatible API
      Replace paid search APIs
    Audience
      Developers
      AI tool builders
    Setup
      Needs Chrome installed
      Optional CAPTCHA priming

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Give Claude, Cursor, or another AI assistant the ability to search the live web for free.

USE CASE 2

Answer questions that need current information, like prices or recent news, inside an AI chat.

USE CASE 3

Add a local OpenAI compatible search API for tools that expect that interface.

USE CASE 4

Replace a paid search API like Tavily or SerpAPI with a free alternative.

What is it built with?

PythonMCPChrome DevTools Protocol

How does it compare?

sophomoresty/gemini-search-mcplucidrains/chroma-pytorchaffaan-m/jarvis
Stars160159158
LanguagePythonPythonPython
Last pushed2022-12-27
MaintenanceDormant
Setup difficultymoderatehardhard
Complexity3/55/55/5
Audiencedeveloperresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Chrome, Edge, or Chromium installed, and may need a one time CAPTCHA solve to set up a persistent browser profile.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

gemini-search-mcp is a free tool that gives AI assistants like Claude or Cursor the ability to search the web in real time, without needing an API key or paying for a subscription. It works through MCP, a standard protocol that lets AI tools call outside services, and connects to Google's AI Mode search feature, the same Gemini powered search available in the AI Mode tab on Google's website. Instead of calling a paid search API, this project runs a real Chrome browser tab in the background and sends search queries through it directly, using Chrome's developer tools protocol. Because the traffic looks exactly like a normal browser rather than an automated script, Google does not apply the rate limits it normally places on programs making many requests quickly, letting the tool handle over 60 searches per minute for free. The project explains that Google throttles based on how trustworthy a connection's technical fingerprint looks rather than by IP address, which is why a real browser tab avoids the usual blocks. The server exposes two main abilities to a connected AI assistant: a web search tool that returns an answer grounded in current search results, and a more general ask tool that lets the AI Mode system decide on its own whether a web search is needed to answer a question. It also runs an OpenAI compatible chat API on a local port, so tools that expect an OpenAI style interface can use it too. Setup requires Python and a Chrome, Edge, or Chromium browser installed on the machine. If Google shows a CAPTCHA challenge, the README explains how to solve it once in a visible browser window and then reuse that saved browser profile for future headless runs. Known limitations include no memory between separate requests, dependence on Google's page structure for extracting answers, and the general fragility of any tool that relies on browser automation rather than an official API. The project is released under the MIT license.

Copy-paste prompts

Prompt 1
Help me install gemini-search-mcp and connect it to Claude Code.
Prompt 2
Show me how to configure gemini-search-mcp in my Claude Desktop config file.
Prompt 3
Explain how gemini-search-mcp avoids Google's rate limits without an API key.
Prompt 4
Walk me through solving the CAPTCHA priming step for gemini-search-mcp.

Frequently asked questions

What is gemini-search-mcp?

A free MCP server that gives AI assistants unlimited real-time web search by driving a real Chrome tab through Google's AI Mode.

What language is gemini-search-mcp written in?

Mainly Python. The stack also includes Python, MCP, Chrome DevTools Protocol.

What license does gemini-search-mcp use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is gemini-search-mcp to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is gemini-search-mcp for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.