mcp-google-server A MCP Server for Google Custom Search and Webpage Reading

A Model Context Protocol server that provides web search capabilities using Google Custom Search API and webpage content extraction functionality.

Setup

Getting Google API Key and Search Engine ID

1. Create a Google Cloud Project:

   • Go to Google Cloud Console

   • Create a new project or select an existing one

   • Enable billing for your project

2. Enable Custom Search API:

   • Go to API Library

   • Search for "Custom Search API"

   • Click "Enable"

3. Get API Key:

   • Go to Credentials

   • Click "Create Credentials" > "API Key"

   • Copy your API key

   • (Optional) Restrict the API key to only Custom Search API

4. Create Custom Search Engine:

   • Go to Programmable Search Engine

   • 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)

Related MCP server: MCP Google Custom Search Server

Development

Install dependencies:

Build the server:

For development with auto-rebuild:

Features

Search Tool

Perform web searches using Google Custom Search API:

• Search the entire web or specific sites

• Control number of results (1-10)

• Get structured results with title, link, and snippet

Webpage Reader Tool

Extract content from any webpage:

• Fetch and parse webpage content

• Extract page title and main text

• Clean content by removing scripts and styles

• Return structured data with title, text, and URL

Installation

Installing via Smithery

To install Google Custom Search Server for Claude Desktop automatically via Smithery:

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

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

Usage

Search Tool

Webpage Reader Tool

Example response from webpage reader:

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

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