ScrapeMapsAPI

Google Maps for AI assistants: search places, get full place details and read every review of a place, paged and sortable.

Hosted MCP Server

npx add-mcp 'https://api.scrapemapsapi.com/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

ScrapeMapsAPI MCP Server

An MCP server that gives AI assistants (Claude Desktop, Claude Code, Cursor, Cline, ...) access to Google Maps places, place details and all the reviews of a place, via the ScrapeMapsAPI API.

No install: connect from Claude or ChatGPT

ScrapeMapsAPI also runs as a remote MCP server with OAuth sign-in, so you can use the same tools from Claude (claude.ai, Desktop, mobile), ChatGPT or any client that supports remote servers, without an API key or anything to install:

https://api.scrapemapsapi.com/mcp
  • Claude: Customize → Connectors → + Add → Add custom connector, paste the URL, then sign in with your ScrapeMapsAPI account and allow access.
  • ChatGPT: chatgpt.com/plugins → + → Add custom MCP server, paste the URL as Server URL, OAuth authentication.
  • Claude Code: claude mcp add --transport http scrapemapsapi https://api.scrapemapsapi.com/mcp, then /mcp to sign in.

Calls use your account's credits exactly like the API; see or disconnect connected apps in Dashboard → Connected apps. Step-by-step guide: https://scrapemapsapi.com/docs/mcp. The package below is the local server (stdio, API key), for developers who prefer to run it themselves; both offer the same tools, prompts and resources.

Features

4 tools: search_places, get_place, get_reviews, resolve_place. Results are compact text built for LLMs: the useful fields only, long texts capped, and the identifiers and cursors needed for the next call.

4 documentation resources: API reference, quickstart, pricing, workflow examples.

3 prompts: summarize the reviews of a place, compare places, find the best places of a kind in an area.

Quick start

1. Get an API key

Create one at scrapemapsapi.com.

2. Configure your client

Claude Desktop (claude_desktop_config.json), Cursor (.cursor/mcp.json), Cline and most other clients:

{
  "mcpServers": {
    "scrapemapsapi": {
      "command": "uvx",
      "args": ["scrapemapsapi-mcp"],
      "env": {
        "SCRAPEMAPSAPI_API_KEY": "your_api_key"
      }
    }
  }
}

Claude Code:

claude mcp add scrapemapsapi -e SCRAPEMAPSAPI_API_KEY=your_api_key -- uvx scrapemapsapi-mcp

3. Use it

  • "Find the five best-rated ramen places in Milan and check what recent reviews say"
  • "Summarize the reviews of https://maps.app.goo.gl/..."
  • "Show me the one-star reviews of Pizzeria Da Michele in Naples, written in Italian"
  • "Is the Louvre open on Monday?"

Tools

ToolWhat it doesCredits
search_placesText search, optionally near lat/lng within radius_km; limit 1-20 (default 10), cursor for more1 per place
get_placeDetails: address, phone, website, opening hours, description, features, photos, IDs2
get_reviewsOne page of reviews; sort relevant/newest/highest/lowest, language (translation target), original_language filter, limit 1-50, cursor1 per 2 reviews
resolve_placeGoogle Maps URL (short links too), place ID, CID or feature ID into every identifier0-1

Places are identified by a place ID (ChIJ...), a CID (digits) or a feature ID (0x...:0x...). Review texts are capped at 600 characters and owner replies at 200. API errors are returned as tool errors with a readable message and what to do next (e.g. top up credits, use resolve_place).

Installation alternatives

# pip
pip install scrapemapsapi-mcp
SCRAPEMAPSAPI_API_KEY=... scrapemapsapi-mcp

# npx (wraps uvx, or python3 -m as a fallback)
SCRAPEMAPSAPI_API_KEY=... npx -y scrapemapsapi-mcp

# Docker
docker build -t scrapemapsapi-mcp . && docker run -i --rm -e SCRAPEMAPSAPI_API_KEY=... scrapemapsapi-mcp

Environment variables

VariableRequiredDescription
SCRAPEMAPSAPI_API_KEYYesYour API key
SCRAPEMAPSAPI_BASE_URLNoOverride the API base URL (default https://api.scrapemapsapi.com), e.g. http://localhost:8000

Development

cd sdks/mcp
uv venv && uv pip install -e ".[dev]"
.venv/bin/pytest
.venv/bin/ruff check .

Test with the MCP Inspector:

SCRAPEMAPSAPI_API_KEY=... SCRAPEMAPSAPI_BASE_URL=http://localhost:8000 uv run mcp dev dev_server.py

License

MIT