Gsearch

io.github.daanielcruzPublished by GitHub account daanielcruzv1.2.3Updated Oct 27, 2026

Free Google Search with inline citations for any MCP-compatible AI tool.

VerifiedSTDIODesktop onlyWeb Search & Scraping

Overview

AI-generated overview

Adds a Google Search grounding tool to MCP clients, returning answers with inline citations and source links for real-time web information.

What you can do
  • Search the web through Google Search grounding and get a written answer with inline citations and source URLs.
  • Use it for current events, news, documentation lookups, or other real-time information.
  • Retries automatically with dynamic backoff when rate limited, so responses typically take a few seconds and can take up to about a minute.
When to use it
Worth adding when you want an assistant to answer questions about current events, news or documentation with cited sources, and you are comfortable signing in with a Google account or supplying a Gemini API key.
Requirements
Runs as a local process, typically launched with npx from the npm package, or via the project's installer. Needs either a Google sign-in through the Antigravity OAuth flow (credentials stored locally) or a Gemini API key set as GEMINI_API_KEY or GSEARCH_API_KEY. GSEARCH_PROJECT can override the auto-detected project. Network access to Google services is required.
Before you install
Signing in stores OAuth credentials in a local file under the user's home directory. API keys are secrets and are ignored when OAuth credentials exist. The server is not affiliated with Google and relies on a public OAuth client; limits, availability and billing depend on the chosen authentication method and Google account. SMS verification may be required on first use. It does not create projects or enable billing.

Installation

In SourceWeft

  1. Open Gsearch in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

🚨 Disclaimer 🚨

This is just a heads-up. We haven't seen any bans from GSearch use.

Not affiliated with Google. Uses the same public OAuth client and API as the Antigravity CLI.

[GSearch - Free Google Search MCP]

GSearch - Free Google Search MCP

[Go] [License: MIT] [MCP]

Give Claude Code, Codex CLI, Cursor, Otherside, and other AI tools real-time web search powered by Google Search grounding. Single binary, zero runtime dependencies.

Install

bash
curl -fsSL https://raw.githubusercontent.com/daanielcruz/gsearch-mcp/main/install.sh | bash

Or build from source:

bash
git clone https://github.com/daanielcruz/gsearch-mcp && cd gsearch-mcpmake build && ./gsearch-installer

The installer downloads the binary and configures Claude Code, Codex, Cursor and Otherside automatically (if available).

How It Works

Claude Code / Codex CLI / Cursor / Otherside / Others        | MCP (stdio)   gsearch-server (Go binary)        | OAuth2   Google Code Assist API        | googleSearch grounding   Answer with [1][2][3] source links

When an AI tool calls google_search, GSearch returns a grounded answer with inline citations:

The current time in Sao Paulo is 08:13 AM.[1][2]Sao Paulo observes Brasilia Time (BRT), UTC-3.[3]
Sources:[1] [Time in Sao Paulo](https://...)[2] [World Clock](https://...)[3] [Time Zone Info](https://...)

Pricing & Limits

GSearch uses the same Google Search grounding API as Antigravity CLI through its public OAuth client, or the Gemini API with an API key. Limits, availability, and billing depend on the selected authentication method and Google account.

The official Gemini CLI states that free and Google One accounts migrated to Antigravity CLI on June 18, 2026, so GSearch now signs in through Antigravity's public OAuth client. Existing Gemini CLI credentials remain readable.

Rate limits are generous for normal usage. The server retries automatically with dynamic backoff on rapid bursts.

Authentication

Two options:

  1. Google sign-in (Antigravity): the installer opens Antigravity CLI's public OAuth flow with PKCE S256 and a localhost loopback callback. Credentials are stored in ~/.gsearch/oauth_creds.json.
  2. API key: paste a Gemini API key from aistudio.google.com into the installer, or set GEMINI_API_KEY / GSEARCH_API_KEY. This skips OAuth and does not require a project. Google sign-in always takes precedence: when OAuth credentials exist, these variables are ignored.

Antigravity sign-in resolves the Code Assist project automatically (SMS verification may be required on first use). If the account requires a user-defined project, the installer accepts an existing Project ID and retries. It does not create projects or enable billing. The default backend is daily-cloudcode-pa.googleapis.com; set GSEARCH_ANTIGRAVITY_HOST=prod to use cloudcode-pa.googleapis.com.

Configuration

The installer configures everything automatically. For manual setup, add to your MCP client config:

json
{  "mcpServers": {    "gsearch": {      "command": "npx",      "args": ["-y", "@daanielcruz/gsearch-mcp"]    }  }}

Works with Claude Code (~/.claude.json), Cursor (~/.cursor/mcp.json), Otherside (~/.otherside/.mcp.json), and other MCP-compatible tools.

For Codex CLI (~/.codex/config.toml):

toml
[mcp_servers.gsearch]command = 'npx'args = ['-y', '@daanielcruz/gsearch-mcp']

Set GSEARCH_PROJECT env var only if auto-detection fails.

License

MIT

Source: README.md at commit 17da84c

Tools

1

Version history

2
  1. v1.2.3LatestOct 24, 2026
  2. v1.1.0Sep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts