
scrapemapsapi
com.scrapemapsapi/scrapemapsapi
Google Maps places, place details and every review of a place, for AI assistants.
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/mcpto 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
| 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
scrapemapsapi-mcppip install scrapemapsapi-mcp