Access Google Search and Web Data

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>