Provides web search capabilities using Google Custom Search API, allowing queries across the entire web or specific sites with configurable result counts.
Uses Google Cloud's Custom Search API to power web search functionality, requiring API keys and search engine configuration from Google Cloud.
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
- Create a Google Cloud Project:
- Go to Google Cloud Console
- Create a new project or select an existing one
- Enable billing for your project
- Enable Custom Search API:
- Go to API Library
- Search for "Custom Search API"
- Click "Enable"
- 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
- 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)
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.
This server cannot be installed
A Model Context Protocol server providing web search capabilities using Google Custom Search API and webpage content extraction functionality.
Related MCP Servers
- AsecurityAlicenseAqualityProvides web search capabilities using Google Custom Search API, enabling users to perform searches through a Model Context Protocol server.Last updated -21,03023JavaScriptMIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that enables LLMs to perform web searches using Google's Custom Search API through a standardized interface.Last updated -123TypeScriptMIT License
- AsecurityFlicenseAqualityA Model Context Protocol server that provides web search capabilities using Google Custom Search API and webpage content extraction functionality.Last updated -2101JavaScript
- AsecurityFlicenseAqualityA Model Context Protocol server that provides web and image search capabilities through Google's Custom Search API, allowing AI assistants like Claude to access current information from the internet.Last updated -21TypeScript