Google Search

Provides Google Custom Search results with optional readability extraction and news-focused deep search.

javascript

2

GitHub Stars

javascript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

This MCP Server lets you perform Google-powered web searches with optional deep content extraction, returning clean article content and supporting domain filters, news-oriented queries, and image results. It combines Google Custom Search with Mozilla Readability to give you quick snippets or full-text articles depending on your needs.

How to use

You use this server by configuring an MCP client to run one of the available search tools. Choose google_search for fast snippet results, deep_search for full article extraction, or deep_search_news for a news-focused deep search. Set your query and optional parameters like the number of results, domain filters, or the search type. The client will return consolidated content ready for display or further processing.

How to install

Prerequisites you need before starting: Node.js 18+ and internet access to install dependencies.

Install the MCP server using npm or npx based on your preference.

{
  "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"
      }
    }
  }
}

Alternative: install the package globally and configure a local stdio server.

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

Then configure the MCP server locally with the same environment variables.

## Configuration and usage notes

Two explicit MCP configurations are documented for running this server. The first uses npx to invoke the MCP directly, and the second uses a globally installed package. Both require your 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" } } } }

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

## Security and credentials

Keep your Google API key and search engine ID confidential. Do not commit the credentials in public repositories. Use environment-variable injection in your deployment environment and rotate keys periodically.

## Examples

Quick snippet search with a basic query using the snippet-only mode.

// Quick search with snippets only google_search({ query: "React hooks tutorial" })


Full deep search with content extraction and optional domain filters.

deep_search({ query: "React best practices 2025" })

## Troubleshooting

If you encounter API quota limits, verify that your API key is active and that your Programmable Search Engine ID (CX) is correctly configured. Check network access and ensure the MCP process has permission to reach Google services.

## Available tools

### google\_search

Simple Google search for quick lookups that returns snippets and does not fetch full page content.

### deep\_search

Comprehensive web search that fetches and extracts full article content using Readability.

### deep\_search\_news

Convenience wrapper for news-focused deep search with optimized content limits.