home / mcp / outscraper mcp server

Outscraper MCP Server

model context protocol for outscraper

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "jayozer-outscraper-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "run",
        "outscraper-mcp"
      ],
      "env": {
        "OUTSCRAPER_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You can access Outscraper’s Google Maps data extraction through an MCP server that exposes two core tools: Google Maps Search and Google Maps Reviews. This server lets you search for businesses, enrich results, and fetch customer reviews in multiple languages and regions, all via MCP-compatible clients.

How to use

Connect with the Outscraper MCP server from your MCP client (such as Claude Desktop or Cursor AI) to run Google Maps data extraction tasks. Use the Google Maps Search tool to find businesses or places with detailed attributes. Use the Google Maps Reviews tool to retrieve customer reviews for a given place. You can enable data enrichment, choose language and region, and sort results to fit your workflow. Set a cutoff date to filter reviews by time and rely on the server to handle large requests asynchronously.

How to install

Prerequisites: you need Node.js and npm (for some install methods) or Python and pip (for Python-based setups). Choose one installation path below and follow the steps in order.

# 1) Installing via Smithery (Recommended)
# This automatically installs the Outscraper MCP server for Claude Desktop
npx -y @smithery/cli install outscraper-mcp --client claude

# 2) Installing via PyPI
# Using pip
pip install outscraper-mcp

# Using uv (recommended for local development)
uv add outscraper-mcp

# Using uvx for a one-time execution
uvx outscraper-mcp

# 3) Manual installation
git clone https://github.com/jayozer/outscraper-mcp
cd outscraper-mcp

# Using uv (recommended)
uv sync

# Using pip to install in editable mode
pip install -e .

Configuration overview

Obtain your API key from Outscraper and set it as an environment variable for the MCP server. You can export it in your shell or place it in a .env file.

export OUTSCRAPER_API_KEY="your_api_key_here"

Client integration tips

In your MCP client configuration, provide the exact command and environment needed to run the Outscraper MCP server. You will pass the API key as an environment variable so the client can authenticate requests.

Available tools

google_maps_search

Search for businesses and places on Google Maps with options for language, region, enrichment, and result sorting.

google_maps_reviews

Extract reviews from Google Maps places with controls for limit, sorting, language, region, and a cutoff date.