Google Search MCP
A Playwright-based Node.js tool that bypasses search engine anti-scraping mechanisms to execute Google searches. Local alternative to SERP APIs with MCP server integration.
What is Google Search MCP?
Google Search MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to playwright-based node.js tool that bypasses search engine anti-scraping mechanisms to execute google searches. local alternative to serp apis with mcp server integration.
A Playwright-based Node.js tool that bypasses search engine anti-scraping mechanisms to execute Google searches. Local alternative to SERP APIs with MCP server integration.
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- search
Use Cases
Maintainer
Works with
Installation
NPM
npx -y google-searchManual Installation
npx -y google-searchConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Google Search MCP
Google Search MCP is a Playwright-based Node.js tool that performs real Google searches from the command line or as an MCP server, bypassing anti-scraping mechanisms without requiring any API key or paid SERP service. It returns structured JSON results (title, URL, snippet) or raw HTML and integrates directly with Claude Desktop and other MCP clients to give AI assistants live web search capabilities. It is a practical local alternative to paid search APIs for developers who need real-time results in their AI workflows.
Prerequisites
- Node.js 18 or higher installed
- npm or npx available on your PATH
- Google Chrome or Chromium browser available (Playwright will manage a separate instance)
- An MCP client such as Claude Desktop or Claude Code CLI
- No API keys required
Clone and build from source
Clone the repository, install dependencies, build the TypeScript source, and link the binary globally so it is accessible as a command.
git clone https://github.com/web-agent-master/google-search.git
cd google-search
npm install
npm run build
npm linkTest a search from the command line
Verify the tool works by running a quick Google search. Results are returned as JSON with title, link, and snippet for each result.
google-search "latest AI research papers"
# Limit results and get raw HTML:
google-search "openai news" --limit 5 --get-html --save-htmlAdd to your MCP client configuration
Edit your claude_desktop_config.json to register the Google Search server. The command uses the npx invocation to run the built package.
{
"mcpServers": {
"google-search": {
"command": "npx",
"args": ["google-search-mcp"]
}
}
}Restart your MCP client
Restart Claude Desktop or your chosen client to load the new MCP server. The search tool should appear in the available tools.
Test with a natural language search prompt
Ask Claude to search Google for something. The server will use Playwright to perform the search and return structured results.
Google Search MCP Examples
Client configuration
Register the Google Search MCP server in your claude_desktop_config.json file.
{
"mcpServers": {
"google-search": {
"command": "npx",
"args": ["google-search-mcp"]
}
}
}Prompts to try
Use these prompts once Google Search MCP is connected to your AI assistant.
- "Search Google for the latest news about Claude AI and summarize the top 5 results"
- "Find the official documentation page for the Playwright Node.js library"
- "Search for 'TypeScript MCP server tutorial' and list the titles and URLs"
- "Look up current pricing for AWS Lambda and compare with Google Cloud Functions"Troubleshooting Google Search MCP
Search returns empty results or the browser fails to launch
Run with the --no-headless flag to see the browser window and diagnose what is happening: google-search "test" --no-headless. If Playwright cannot find a browser, run 'npx playwright install chromium' to download it.
Google blocks the search with a CAPTCHA or bot detection page
The tool uses browser fingerprinting and state restoration to avoid detection, but may still be blocked under heavy use. Use the --state-file flag to persist browser state between runs, which helps maintain a trusted browser session: google-search "query" --state-file ~/.google-search-state.json
MCP server command not found after npm link
Run 'npm list -g | grep google-search' to confirm the global link. If not found, run 'npm link' again from inside the cloned repository directory. On macOS/Linux you may need sudo for global npm links.
Frequently Asked Questions about Google Search MCP
What is Google Search MCP?
Google Search MCP is a Model Context Protocol (MCP) server that playwright-based node.js tool that bypasses search engine anti-scraping mechanisms to execute google searches. local alternative to serp apis with mcp server integration. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Google Search MCP?
Install via npm with the command: npx -y google-search. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Google Search MCP?
Google Search MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Google Search MCP free to use?
Yes, Google Search MCP is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Google Search MCP Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to Google Search MCP? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Xiaohongshu
★ 13.7kMCP for xiaohongshu.com
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.
Set Up Google Search MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Google Search MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.