What can you do with this server?

This MCP server enables comprehensive web searches through Google's Custom Search API with advanced content extraction capabilities. * Perform three types of searches: google_search for quick snippet-only results (1-10 results), deep_search for comprehensive searches with full content extraction across web/news/images, and deep_search_news optimized specifically for news articles and current events * Extract clean article content using Mozilla's Readability algorithm (same as Firefox Reader View) to remove ads and clutter * Filter search results by including specific domains (e.g., only GitHub and Reddit) or excluding unwanted ones (e.g., block Pinterest and Facebook) * Search across different content types including general web pages, news articles, and images * Customize search parameters including number of results (1-10) and maximum content length per page (5,000-100,000 characters) * Override API credentials on a per-tool-call basis if needed * Deploy flexibly in local mode with your own Google API credentials or hosted mode with TUI AD authentication for enterprise deployments * Benefit from reliability features including automatic retries with exponential backoff and controlled concurrency to handle network issues gracefully

Which integrations are available for this server?

Performs comprehensive web, news, and image searches using the Google Custom Search API, offering features like snippet-only lookups, full content extraction from results, and domain-specific filtering. Integrates with the Google Custom Search JSON API to enable programmatic access to web search results and advanced content retrieval.

How do I use Google Search MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Google Search MCP Server deep search for the latest news on generative AI breakthroughs" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Google Search MCP Server

An MCP (Model Context Protocol) server that performs comprehensive web searches using Google Custom Search JSON API with advanced content extraction using Mozilla's Readability algorithm.

Features

Three Search Modes:
- google_search - Fast snippet-only search for quick lookups
- deep_search - Full content extraction with Readability algorithm
- deep_search_news - News-optimized deep search
Google Custom Search API - Uses official Google Custom Search JSON API
Advanced Content Extraction - Uses Mozilla's Readability algorithm (same as Firefox Reader View) for clean article extraction
Multiple Search Types - Web search, news search, and image search
Domain Filtering - Include or exclude specific domains from results
Retry Logic - Automatic retries with exponential backoff for reliability
Controlled Concurrency - Fetches pages in batches to avoid overwhelming servers

Deployment Modes

This MCP server supports two deployment modes:

1. Local/Third-Party Mode (Default)

Run via npx with user-provided Google API credentials:

{ "mcpServers": { "google-search": { "command": "npx", "args": ["-y", "@thejusdutt/google-search-mcp"], "env": { "GOOGLE_API_KEY": "your-google-api-key", "GOOGLE_CX": "your-search-engine-id" } } } }

2. Hosted Mode with TUI AD Authentication

Deploy to infrastructure with TUI Active Directory SSO authentication:

Environment Variables:

HOSTED_MODE=true - Enables authentication
HEALTH_CHECK_TOKEN - Bearer token for MCP Registry health checks
GOOGLE_API_KEY (optional) - Default API key if users don't provide their own
GOOGLE_CX (optional) - Default Search Engine ID if users don't provide their own

Authentication:

Health checks use bearer token authentication
End users authenticate via TUI AD (JWT tokens validated against https://idp.devops.tui/keys)
Users can pass their own google_api_key and google_cx parameters with each tool call

Gateway URL: https://mcp.devops.tui/google-search/mcp

Prerequisites

Get Google Custom Search API Credentials

Go to Google Cloud Console
Create a new project or select an existing one
Enable the "Custom Search API"
Go to "Credentials" and create an API key
Go to Programmable Search Engine
Create a new search engine and get your Search Engine ID (CX)

You'll need:

GOOGLE_API_KEY - Your Google Cloud API key
GOOGLE_CX - Your Programmable Search Engine ID

Installation

Using npx (Recommended)

No installation needed - just configure your MCP client:

{ "mcpServers": { "google-search": { "command": "npx", "args": ["-y", "@thejusdutt/google-search-mcp"], "env": { "GOOGLE_API_KEY": "your-google-api-key", "GOOGLE_CX": "your-search-engine-id" } } } }

Global Installation

npm install -g @thejusdutt/google-search-mcp

Then configure:

{ "mcpServers": { "google-search": { "command": "google-search-mcp", "env": { "GOOGLE_API_KEY": "your-google-api-key", "GOOGLE_CX": "your-search-engine-id" } } } }

Tools

`google_search`

Simple Google search for quick lookups. Returns snippets only without fetching full page content.

Parameter	Type	Default	Description
`query`	string	required	The search query
`num_results`	number	10	Number of results (1-10)
`google_api_key`	string	-	Google API key (optional, uses server default)
`google_cx`	string	-	Search Engine ID (optional, uses server default)

Example:

// Quick search with snippets only google_search({ query: "React hooks tutorial" }) // With custom API credentials google_search({ query: "React hooks tutorial", google_api_key: "your-key", google_cx: "your-cx" })

`deep_search`

Comprehensive web search with full content extraction.

Parameter	Type	Default	Description
`query`	string	required	The search query
`num_results`	number	10	Number of results (1-10)
`max_content_per_page`	number	50000	Max characters per page (5000-100000)
`search_type`	string	"web"	Search type: "web", "news", or "images"
`include_domains`	string	-	Comma-separated domains to include
`exclude_domains`	string	-	Comma-separated domains to exclude
`google_api_key`	string	-	Google API key (optional, uses server default)
`google_cx`	string	-	Search Engine ID (optional, uses server default)

Examples:

// Basic web search deep_search({ query: "React best practices 2025" }) // News search deep_search({ query: "AI announcements", search_type: "news" }) // Search specific sites only deep_search({ query: "TypeScript tips", include_domains: "github.com,dev.to" }) // Exclude certain sites deep_search({ query: "web development trends", exclude_domains: "pinterest.com,facebook.com" })

`deep_search_news`

Convenience wrapper for news search. Equivalent to calling deep_search with search_type: "news" and optimized content limits.

Parameter	Type	Default	Description
`query`	string	required	The news topic to search
`num_results`	number	10	Number of articles (1-10)
`max_content_per_page`	number	30000	Max characters per article
`google_api_key`	string	-	Google API key (optional, uses server default)
`google_cx`	string	-	Search Engine ID (optional, uses server default)

Example:

deep_search_news({ query: "OpenAI latest updates" })

Configuration

Kiro

Add to ~/.kiro/settings/mcp.json:

{ "mcpServers": { "google-search": { "command": "npx", "args": ["-y", "@thejusdutt/google-search-mcp"], "env": { "GOOGLE_API_KEY": "your-google-api-key", "GOOGLE_CX": "your-search-engine-id" } } } }

Claude Desktop

Add to claude_desktop_config.json:

{ "mcpServers": { "google-search": { "command": "npx", "args": ["-y", "@thejusdutt/google-search-mcp"], "env": { "GOOGLE_API_KEY": "your-google-api-key", "GOOGLE_CX": "your-search-engine-id" } } } }

How It Works

Search - Queries Google Custom Search API to get top results
Fetch - Downloads each result page with retry logic
Extract - Uses Mozilla Readability to extract clean article content
Format - Returns consolidated markdown with full content from each page

Requirements

Node.js 18+
Google Cloud API key with Custom Search API enabled
Programmable Search Engine ID (CX)

License

MIT

Author

thejusdutt

Contributing

Issues and PRs welcome at GitHub

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

Resources

Need Help?

Report Issue

Related Servers

Google Search MCP Server

Google Search MCP Server

Features

Deployment Modes

1. Local/Third-Party Mode (Default)

2. Hosted Mode with TUI AD Authentication

Prerequisites

Get Google Custom Search API Credentials

Installation

Using npx (Recommended)

Global Installation

Tools

`google_search`

`deep_search`

`deep_search_news`

Configuration

Kiro

Claude Desktop

How It Works

Requirements

License

Author

Contributing

Resources

Tools

New MCP Servers

Latest Blog Posts

MCP directory API