Skip to main content
Glama
scrapemapsapi-mcp

scrapemapsapi-mcp

Official

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.

Related MCP server: mcp-google-maps

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

Tool

What it does

Credits

search_places

Text search, optionally near lat/lng within radius_km; limit 1-20 (default 10), cursor for more

1 per place

get_place

Details: address, phone, website, opening hours, description, features, photos, IDs

2

get_reviews

One page of reviews; sort relevant/newest/highest/lowest, language (translation target), original_language filter, limit 1-50, cursor

1 per 2 reviews

resolve_place

Google Maps URL (short links too), place ID, CID or feature ID into every identifier

0-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

Variable

Required

Description

SCRAPEMAPSAPI_API_KEY

Yes

Your API key

SCRAPEMAPSAPI_BASE_URL

No

Override 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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers