Google Search

v1.0.0Search & Data Extractionstable

Enables Large Language Models to perform real-time web searches using Google Custom Search API. Integrates with Claude Desktop to retrieve current information from the internet.

mcpmcp-servermcp-tools
Share:
16
Stars
0
Downloads
0
Weekly
0/5

What is Google Search?

Google Search is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables large language models to perform real-time web searches using google custom search api. integrates with claude desktop to retrieve current information from the internet.

Enables Large Language Models to perform real-time web searches using Google Custom Search API. Integrates with Claude Desktop to retrieve current information from the internet.

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

Features

  • Enables Large Language Models to perform real-time web searc

Use Cases

Perform real-time web searches for current information.
Retrieve up-to-date search results within Claude conversations.
Enable LLMs to access internet data via Google Custom Search API.
LicenseMIT License
Languagetypescript
Versionv1.0.0
UpdatedMay 17, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx google-search-mcp

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 Search

The Google Search MCP server enables AI assistants like Claude to perform real-time web searches using browser automation with fingerprint spoofing and CAPTCHA handling. Unlike API-based search tools, it simulates real browser behavior to retrieve Google search results without requiring an API key. This makes it practical for developers who want to give their AI assistant current web information without setting up a Google Custom Search API account.

Prerequisites

  • Node.js 18 or later installed
  • An MCP-compatible client such as Claude Desktop or Cursor
  • npx available in your PATH (comes with Node.js)
  • A system capable of running a headless Chromium browser (used internally)
1

Verify Node.js is installed

Ensure Node.js 18+ is installed on your system. The server runs via npx so no separate global install is needed.

node --version
2

Test the server directly

Run the server once via npx to confirm it starts correctly. It will launch a headless browser session and listen for MCP tool calls over stdio.

npx -y @mcp-server/google-search-mcp@latest
3

Open your MCP client configuration file

For Claude Desktop on macOS, open ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows it is at %APPDATA%\Claude\claude_desktop_config.json. Create the file if it does not exist.

4

Add the server to your config

Insert the google-search server block. No environment variables or API keys are required — the server manages browser state in ~/.google-search-browser-state.json automatically.

{
  "mcpServers": {
    "google-search": {
      "command": "npx",
      "args": ["-y", "@mcp-server/google-search-mcp@latest"]
    }
  }
}
5

Restart Claude Desktop

Quit and reopen Claude Desktop so it picks up the new server configuration. You should see the google-search tool listed in the tools panel.

Google Search Examples

Client configuration

Minimal Claude Desktop config for the Google Search MCP server. No API keys needed.

{
  "mcpServers": {
    "google-search": {
      "command": "npx",
      "args": ["-y", "@mcp-server/google-search-mcp@latest"]
    }
  }
}

Prompts to try

Example prompts that exercise the search tool with different language and region settings.

- "Search for the latest news about TypeScript 5.5 and summarize the key changes"
- "Find the top 5 results for 'best open source LLM 2025' and compare them"
- "Search Google for 'MCP Model Context Protocol tutorial' and list the most relevant links"
- "Look up current weather in Tokyo using a web search"

Troubleshooting Google Search

CAPTCHA prompts or the browser switches to headed (visible) mode unexpectedly

This is expected behavior — the server automatically switches to headed mode to handle CAPTCHAs. Allow the CAPTCHA to complete and it will return to headless mode. Subsequent searches usually proceed without interruption.

The npx command hangs or fails to start

Clear the npx cache with 'npx clear-npx-cache' and retry. Also ensure Chromium can be downloaded by npx — check that your network allows access to the Chromium CDN and that you have sufficient disk space.

Claude Desktop does not show the google-search tool after restarting

Validate your JSON config file for syntax errors (trailing commas, mismatched braces). Use 'npx -y @mcp-server/google-search-mcp@latest' in a terminal to confirm the server starts without errors before adding it to the config.

Frequently Asked Questions about Google Search

What is Google Search?

Google Search is a Model Context Protocol (MCP) server that enables large language models to perform real-time web searches using google custom search api. integrates with claude desktop to retrieve current information from the internet. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Google Search?

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

Which AI clients work with Google Search?

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

Is Google Search free to use?

Yes, Google Search is open source and available under the MIT License 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-search-mcp": { "command": "npx", "args": ["-y", "google-search-mcp"] } } }

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

Read the full setup guide →

Ready to use Google Search?

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