# Gsearch Mcp

> Free Google Search Grounding MCP

- **Type:** MCP server
- **Install:** `agentstack add mcp-daanielcruz-gsearch-mcp`
- **Verified:** Pending review
- **Seller:** [daanielcruz](https://agentstack.voostack.com/s/daanielcruz)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [daanielcruz](https://github.com/daanielcruz)
- **Source:** https://github.com/daanielcruz/gsearch-mcp

## Install

```sh
agentstack add mcp-daanielcruz-gsearch-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

>
> ### 🚨 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 [open-source Gemini CLI](https://github.com/google-gemini/gemini-cli).
>
> 
> Google recently banned some OpenClaw users. OpenClaw use cases for oauth providers look abusive to me. GSearch doesn't fit that pattern. Risk still exists.
>
> Requests carry Gemini CLI's User-Agent, ideType, and request shape, so they're probably indistinguishable from the official client on the wire _(if u a googler reading this: we good ppl, plz don't hunt us 🙏)_. If that bothers you, use a throwaway Google account.

---

# GSearch - Free Google Search MCP

[](https://go.dev)
[](LICENSE)
[](https://modelcontextprotocol.io)

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

## 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-mcp
make build && ./gsearch-installer
```

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

## How It Works

```
Claude Code / Codex CLI / Cursor / 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 [Gemini CLI](https://github.com/google-gemini/gemini-cli). **Free with any Google account.** No API key, no credit card, no billing setup.

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

## Authentication

Three options:

1. **Gemini CLI** (if installed) — GSearch reuses existing credentials from `~/.gemini/oauth_creds.json`
2. **Interactive OAuth** — `./gsearch-installer` opens your browser for Google sign-in
3. **API key** — paste a Gemini API key from [aistudio.google.com](https://aistudio.google.com/apikey) into the installer, or set `GEMINI_API_KEY` / `GSEARCH_API_KEY` env var

OAuth modes auto-provision new accounts via the Google Code Assist API (SMS verification may be required on first use). API key mode skips OAuth entirely and hits the Gemini API directly.

## 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`), and any MCP-compatible tool.

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 & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [daanielcruz](https://github.com/daanielcruz)
- **Source:** [daanielcruz/gsearch-mcp](https://github.com/daanielcruz/gsearch-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: flagged — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-daanielcruz-gsearch-mcp
- Seller: https://agentstack.voostack.com/s/daanielcruz
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.