Google Search MCP Server

Overview

Google Search MCP Server provides web search capabilities using Google Custom Search API and webpage content extraction functionality. This tool enables AI assistants to search the web for up-to-date information and extract content from specific webpages.

Prerequisites

Before using this MCP server, you'll need to set up Google API credentials:

1. Create a Google Cloud Project:

   • Go to Google Cloud Console (https://console.cloud.google.com/)
   • Create a new project or select an existing one
   • Enable billing for your project

2. Enable Custom Search API:

   • Go to API Library in Google Cloud Console
   • Search for "Custom Search API"
   • Click "Enable"

3. Get API Key:

   • Go to Credentials in Google Cloud Console
   • Click "Create Credentials" > "API Key"
   • Copy your API key
   • Optionally restrict the API key to only Custom Search API

4. Create Custom Search Engine:

   • Go to Programmable Search Engine (https://programmablesearchengine.google.com/create/new)
   • Enter the sites you want to search (use www.google.com for general web search)
   • Click "Create"
   • On the next page, click "Customize"
   • In the settings, enable "Search the entire web"
   • Copy your Search Engine ID (cx)

Installation

Using Smithery

The easiest way to install the Google Search MCP server is via Smithery:

npx -y @smithery/cli install @adenot/mcp-google-search --client claude

Manual Installation

1. Install the package:

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

2. Configure your AI assistant client to use the MCP server.

Configuration

To use with Claude Desktop, add the server configuration with your Google API credentials:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

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

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. You can use the MCP Inspector for debugging:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.