Serper (Google Search)
About
Enables AI to perform Google searches via the Serper API with support for location, language, and time period filters.
Details
- Author
- garymengcom
- Repository
- garylab/serper-mcp-server
- GitHub stars
- 1
- Downloads
- 2,361
- Categories
- AI, Design, Developer Tools, Search, Knowledge Base, Infrastructure, API, Database
- Tags
- #web
Jump to
- Provides 13 different Google search tool types (web, images, videos, places, maps, reviews, news, shopping, lens, scholar, patents, autocomplete).
- Includes a webpage_scrape tool for scraping web page content.
- Installable via Smithery, uvx, or pip.
- Requires only a Serper API key for authentication.
- Released under the MIT License.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Serper (Google Search)Command (node, npx, python, etc.)uvxArguments-
Argument 1
serper-mcp-server
Environment-
SERPER_API_KEY
<Your Serper API key>
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
To install Serper MCP Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @garylab/serper-mcp-server --client claude
1. Make sure the pip or pip3 is in your os system.
```bash
pip install serper-mcp-server
google_search
Perform a Google search with specified parameters.
google_search_images
Perform a Google search for images with specified parameters.
google_search_videos
Perform a Google search for videos with specified parameters.
google_search_places
Perform a Google search for places with specified parameters.
google_search_maps
Perform a Google search for maps with specified parameters.
google_search_reviews
Perform a Google search for reviews with specified parameters.
google_search_news
Perform a Google search for news with specified parameters.
google_search_shopping
Perform a Google search for shopping results with specified parameters.
google_search_lens
Perform a Google search using Google Lens with specified parameters.
google_search_scholar
Perform a Google search for scholarly articles with specified parameters.
google_search_patents
Perform a Google search for patents with specified parameters.
google_search_autocomplete
Get autocomplete suggestions from Google search with specified parameters.
webpage_scrape
Scrape content from a specified webpage.
- google_search - Set all the parameters
- google_search_images - Set all the parameters
- google_search_videos - Set all the parameters
- google_search_places - Set all the parameters
- google_search_maps - Set all the parameters
- google_search_reviews - Set all the parameters
- google_search_news - Set all the parameters
- google_search_shopping - Set all the parameters
- google_search_lens - Set all the parameters
- google_search_scholar - Set all the parameters
- google_search_patents - Set all the parameters
- google_search_autocomplete - Set all the parameters
- webpage_scrape - Set all the parameters
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"serper (google search)": {
"env": {
"SERPER_API_KEY": "<Your Serper API key>"
},
"args": [
"serper-mcp-server"
],
"command": "uvx"
}
}
}Linux
{
"env": {
"SERPER_API_KEY": "<Your Serper API key>"
},
"args": [
"-m",
"serper_mcp_server"
],
"command": "python3"
}Macos
{
"env": {
"SERPER_API_KEY": "<Your Serper API key>"
},
"args": [
"serper-mcp-server"
],
"command": "uvx"
}Windows
{
"env": {
"SERPER_API_KEY": "<Your Serper API key>"
},
"args": [
"-m",
"serper_mcp_server"
],
"command": "python3"
}Serper MCP Server
A Model Context Protocol server that provides Google Search via Serper. This server enables LLMs to get search result information from Google.
Available Tools
- google_search - Set all the parameters
- google_search_images - Set all the parameters
- google_search_videos - Set all the parameters
- google_search_places - Set all the parameters
- google_search_maps - Set all the parameters
- google_search_reviews - Set all the parameters
- google_search_news - Set all the parameters
- google_search_shopping - Set all the parameters
- google_search_lens - Set all the parameters
- google_search_scholar - Set all the parameters
- google_search_patents - Set all the parameters
- google_search_autocomplete - Set all the parameters
- webpage_scrape - Set all the parameters
Usage
Installing via Smithery
To install Serper MCP Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @garylab/serper-mcp-server --client claude
Using uv (recommended)
1. Make sure you had installed uv on your os system.
2. In your MCP client code configuration or Claude settings (file claude_desktop_config.json) add serper mcp server:
{
"mcpServers": {
"serper": {
"command": "uvx",
"args": ["serper-mcp-server"],
"env": {
"SERPER_API_KEY": "<Your Serper API key>"
}
}
}
}
uv will download mcp server automatically using uvx from pypi.org and apply to your MCP client.
Using pip for project
1. Add serper-mcp-server to your MCP client code requirements.txt file.
serper-mcp-server
2. Install the dependencies.
pip install -r requirements.txt
3. Add the configuration for you client:
{
"mcpServers": {
"serper": {
"command": "python3",
"args": ["-m", "serper_mcp_server"],
"env": {
"SERPER_API_KEY": "<Your Serper API key>"
}
}
}
}
Using pip for globally usage
1. Make sure the pip or pip3 is in your os system.
pip install serper-mcp-server
# or
pip3 install serper-mcp-server
2. MCP client code configuration or Claude settings, add serper mcp server:
{
"mcpServers": {
"serper": {
"command": "python3",
"args": ["serper-mcp-server"],
"env": {
"SERPER_API_KEY": "<Your Serper API key>"
}
}
}
}
Debugging
You can use the MCP inspector to debug the server. For uvx installations:
npx @modelcontextprotocol/inspector uvx serper-mcp-server
Or if you've installed the package in a specific directory or are developing on it:
git clone https://github.com/garylab/serper-mcp-server.git
cd serper-mcp-server
npx @modelcontextprotocol/inspector uv run serper-mcp-server -e SERPER_API_KEY=<the key>
License
serper-mcp-server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
