Google AI Mode

v1.0.0Search & Data Extractionstable

MCP server for free Google AI Mode search with citations. Query optimization, CAPTCHA handling, multi-agent support. Works with Claude Code, Cursor, Cline, Windsurf.

browser-automationcitationsclaude-codeclinecodex
Share:
119
Stars
0
Downloads
0
Weekly
0/5

What is Google AI Mode?

Google AI Mode is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for free google ai mode search with citations. query optimization, captcha handling, multi-agent support. works with claude code, cursor, cline, windsurf.

MCP server for free Google AI Mode search with citations. Query optimization, CAPTCHA handling, multi-agent support. Works with Claude Code, Cursor, Cline, Windsurf.

This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • MCP server for free Google AI Mode search with citations. Qu

Use Cases

Perform free AI-powered web searches with built-in citations.
Query Google AI Mode with automatic CAPTCHA handling and result optimization.
Use AI-enhanced search across multiple AI clients including Claude Code and Cursor.
PleasePrompto

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx google-ai-mode

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Google AI Mode

Google AI Mode MCP Server brings Google's AI-synthesized search results directly into your AI coding assistant or chat client. Unlike traditional web search tools that return raw links, this server queries Google AI Mode and returns a single synthesized answer with inline citations, dramatically reducing token usage. It is useful for developers who want up-to-date, well-sourced research results without leaving their workflow in Claude Code, Cursor, Windsurf, or Cline.

Prerequisites

  • Node.js 18 or later installed on your machine
  • An MCP-compatible client (Claude Code, Cursor, Windsurf, Cline, VS Code with MCP extension, or Zed)
  • A Google account (used by the headless browser; no API key required)
  • On Linux or WSL: Xvfb installed if running in a headless environment (xvfb-run wrapper)
1

Install via Claude Code (quickest path)

Run the one-liner to register the server directly in Claude Code. This pulls the latest published package from npm and wires it up automatically.

claude mcp add google-ai-search npx google-ai-mode-mcp@latest
2

Add to other MCP clients (Cursor, Windsurf, VS Code)

For clients that use a JSON config file, add the server entry below. No API key is required — the server launches a headless Chromium browser internally.

{
  "mcpServers": {
    "google-ai-search": {
      "command": "npx",
      "args": ["google-ai-mode-mcp@latest"]
    }
  }
}
3

Handle first-run CAPTCHA (if triggered)

On first use Google may present a CAPTCHA. Ask your AI client to switch to visible mode, solve the CAPTCHA in the browser window that appears, then continue. The server detects completion automatically.

4

Clear the browser profile if CAPTCHAs persist

If you keep hitting CAPTCHAs across sessions, delete the cached browser profile to start fresh.

# macOS / Linux
rm -rf ~/.local/share/google-ai-mode-mcp/chrome_profile

# Windows (PowerShell)
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\google-ai-mode-mcp\chrome_profile"
5

Configure optional environment variables

Tune timeouts and headless mode by setting environment variables in your MCP config's env block. Defaults work for most users.

{
  "mcpServers": {
    "google-ai-search": {
      "command": "npx",
      "args": ["google-ai-mode-mcp@latest"],
      "env": {
        "GOOGLE_AI_HEADLESS": "true",
        "GOOGLE_AI_RESPONSE_TIMEOUT": "30000",
        "GOOGLE_AI_CAPTCHA_TIMEOUT": "300000",
        "GOOGLE_AI_CAPTCHA_POLL_INTERVAL": "3000"
      }
    }
  }
}

Google AI Mode Examples

Client configuration

Minimal JSON config block for Claude Desktop or any MCP-compatible client.

{
  "mcpServers": {
    "google-ai-search": {
      "command": "npx",
      "args": ["google-ai-mode-mcp@latest"],
      "env": {
        "GOOGLE_AI_HEADLESS": "true",
        "GOOGLE_AI_RESPONSE_TIMEOUT": "30000"
      }
    }
  }
}

Prompts to try

Use the search_ai tool by asking natural research questions. The server synthesizes dozens of sources into one cited answer.

- "Search Google AI Mode for: Next.js 15 App Router best practices"
- "What are the breaking changes in React 19?"
- "Compare PostgreSQL vs MySQL for a high-write SaaS workload in 2025"
- "Research the latest OWASP Top 10 vulnerabilities and save results to a file"
- "What are the new features in Python 3.13?"

Troubleshooting Google AI Mode

Browser window never opens or CAPTCHA is not detected

Set GOOGLE_AI_HEADLESS=false in your env block so the Chromium window is visible, then manually complete the CAPTCHA. After success you can revert to headless mode.

X-Server errors on Linux or WSL

Install Xvfb (sudo apt install xvfb) and wrap the command: change the args to ["xvfb-run", "npx", "google-ai-mode-mcp@latest"] or prefix via your shell.

Search hangs and never returns

Increase GOOGLE_AI_RESPONSE_TIMEOUT (value in milliseconds, e.g. "60000" for 60 s). If it still hangs, clear the Chrome profile directory and restart the server.

Frequently Asked Questions about Google AI Mode

What is Google AI Mode?

Google AI Mode is a Model Context Protocol (MCP) server that mcp server for free google ai mode search with citations. query optimization, captcha handling, multi-agent support. works with claude code, cursor, cline, windsurf. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Google AI Mode?

Follow the installation instructions on the Google AI Mode GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Google AI Mode?

Google AI Mode works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Google AI Mode free to use?

Yes, Google AI Mode is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Search & Data Extraction MCP Servers

Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "google-ai-mode": { "command": "npx", "args": ["-y", "google-ai-mode"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Google AI Mode?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides