A
securityA
licenseA
qualityA Model Context Protocol server that enables LLMs to perform web searches using Google's Custom Search API through a standardized interface.
Last updated -
37
MIT License
The MCP Google Server enables two main functionalities:
Search Tool: Perform web searches using Google Custom Search API
Customize queries for entire web or specific sites
Control result count (1-10)
Get structured results with title, link, and snippet
Webpage Reader Tool: Extract content from webpages
Fetch and parse content
Extract title and main text
Clean content by removing scripts and styles
Return structured data
Allows performing web searches using Google Custom Search API, returning structured results with title, link, and snippet.
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:
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:
npm install
Build the server:
npm run build
For development with auto-rebuild:
npm run watch
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:
npx -y @smithery/cli install @adenot/mcp-google-search --client claude
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
{
"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"
}
}
}
}
Usage
Search Tool
{
"name": "search",
"arguments": {
"query": "your search query",
"num": 5 // optional, default is 5, max is 10
}
}
Webpage Reader Tool
{
"name": "read_webpage",
"arguments": {
"url": "https://example.com"
}
}
Example response from webpage reader:
{
"title": "Example Domain",
"text": "Extracted and cleaned webpage content...",
"url": "https://example.com"
}
Debugging
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:
npm run inspector
The Inspector will provide a URL to access debugging tools in your browser.
Related MCP Servers
- AsecurityFlicenseAqualityA Model Context Protocol server that provides web search capabilities using Google Custom Search API and webpage content extraction functionality.Last updated -242
- 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 -21
- -securityAlicense-qualityA Model Context Protocol server that enables AI assistants to perform web searches using Google Search API, returning up to 20 search results in JSON format.Last updated -2Apache 2.0