search-web

Serper (Google Search)▌

by garylab

Serper enables AI to access Google Search results via a powerful Google Search API, supporting location, language, and t

Enables AI to perform Google searches via the Serper API with support for location, language, and time period filters.

github stars

★ 28

GitHub npm

12+ specialized search typesLocation and language filteringIncludes Google Lens visual search

best for

/ AI assistants needing current web information
/ Research and fact-checking workflows
/ Content creation requiring up-to-date data
/ Academic research and citation finding

capabilities

/ Perform Google web searches with filters
/ Search Google Images, videos, and news
/ Find places and maps information
/ Search Google Scholar and patents
/ Get shopping results and reviews
/ Scrape webpage content

what it does

Provides Google search capabilities to AI through the Serper API with filtering options for location, language, and time periods. Includes specialized searches for images, news, shopping, academic papers, and more.

about

Serper (Google Search) is a community-built MCP server published by garylab that provides AI assistants with tools and capabilities via the Model Context Protocol. Serper enables AI to access Google Search results via a powerful Google Search API, supporting location, language, and t It is categorized under search web.

how to install

You can install Serper (Google Search) in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.

license

MIT

Serper (Google Search) is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

readme

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)

Make sure you had installed uv on your os system.

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

Add serper-mcp-server to your MCP client code requirements.txt file.
```
serper-mcp-server
```
Install the dependencies.
```
pip install -r requirements.txt
```

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

Make sure the pip or pip3 is in your os system.

pip install serper-mcp-server
# or
pip3 install serper-mcp-server

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.