Skip to content
Back to search

mcp-server

MCP server for Google Maps places and reviews: give Claude, Cursor and other AI assistants place search, details and all reviews via ScrapeMapsAPI.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/scrapemapsapi--mcp-server/badge.svg)](/listings/scrapemapsapi--mcp-server)

HTML

<a href="/listings/scrapemapsapi--mcp-server"><img src="/api/listings/scrapemapsapi--mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Get an API key

Create one at [scrapemapsapi.com](https://scrapemapsapi.com/dashboard/api-keys).

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?"

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 121 lines
  1. # ScrapeMapsAPI MCP Server
  2. <!-- mcp-name: com.scrapemapsapi/scrapemapsapi -->
  3. An [MCP](https://modelcontextprotocol.io) 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](https://scrapemapsapi.com) API.
  4. ## No install: connect from Claude or ChatGPT
  5. ScrapeMapsAPI also runs as a **remote MCP server** with OAuth sign-in, so you can use the same tools from
  6. Claude (claude.ai, Desktop, mobile), ChatGPT or any client that supports remote servers, without an API key or
  7. anything to install:
  8. ```
  9. https://api.scrapemapsapi.com/mcp
  10. ```
  11. - **Claude**: Customize → Connectors → + Add → Add custom connector, paste the URL, then sign in with your
  12. ScrapeMapsAPI account and allow access.
  13. - **ChatGPT**: chatgpt.com/plugins → + → Add custom MCP server, paste the URL as Server URL, OAuth authentication.
  14. - **Claude Code**: `claude mcp add --transport http scrapemapsapi https://api.scrapemapsapi.com/mcp`, then `/mcp`
  15. to sign in.
  16. Calls use your account's credits exactly like the API; see or disconnect connected apps in Dashboard → Connected
  17. apps. Step-by-step guide: https://scrapemapsapi.com/docs/mcp. The package below is the **local** server (stdio,
  18. API key), for developers who prefer to run it themselves; both offer the same tools, prompts and resources.
  19. ## Features
  20. **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.
  21. **4 documentation resources**: API reference, quickstart, pricing, workflow examples.
  22. **3 prompts**: summarize the reviews of a place, compare places, find the best places of a kind in an area.
  23. ## Quick start
  24. ### 1. Get an API key
  25. Create one at [scrapemapsapi.com](https://scrapemapsapi.com/dashboard/api-keys).
  26. ### 2. Configure your client
  27. Claude Desktop (`claude_desktop_config.json`), Cursor (`.cursor/mcp.json`), Cline and most other clients:
  28. ```json
  29. {
  30. "mcpServers": {
  31. "scrapemapsapi": {
  32. "command": "uvx",
  33. "args": ["scrapemapsapi-mcp"],
  34. "env": {
  35. "SCRAPEMAPSAPI_API_KEY": "your_api_key"
  36. }
  37. }
  38. }
  39. }
  40. ```
  41. Claude Code:
  42. ```bash
  43. claude mcp add scrapemapsapi -e SCRAPEMAPSAPI_API_KEY=your_api_key -- uvx scrapemapsapi-mcp
  44. ```
  45. ### 3. Use it
  46. - "Find the five best-rated ramen places in Milan and check what recent reviews say"
  47. - "Summarize the reviews of https://maps.app.goo.gl/..."
  48. - "Show me the one-star reviews of Pizzeria Da Michele in Naples, written in Italian"
  49. - "Is the Louvre open on Monday?"
  50. ## Tools
  51. | Tool | What it does | Credits |
  52. |------|-------------|---------|
  53. | `search_places` | Text search, optionally near `lat`/`lng` within `radius_km`; `limit` 1-20 (default 10), `cursor` for more | 1 per place |
  54. | `get_place` | Details: address, phone, website, opening hours, description, features, photos, IDs | 2 |
  55. | `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 |
  56. | `resolve_place` | Google Maps URL (short links too), place ID, CID or feature ID into every identifier | 0-1 |
  57. 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`).
  58. ## Installation alternatives
  59. ```bash
  60. # pip
  61. pip install scrapemapsapi-mcp
  62. SCRAPEMAPSAPI_API_KEY=... scrapemapsapi-mcp
  63. # npx (wraps uvx, or python3 -m as a fallback)
  64. SCRAPEMAPSAPI_API_KEY=... npx -y scrapemapsapi-mcp
  65. # Docker
  66. docker build -t scrapemapsapi-mcp . && docker run -i --rm -e SCRAPEMAPSAPI_API_KEY=... scrapemapsapi-mcp
  67. ```
  68. ## Environment variables
  69. | Variable | Required | Description |
  70. |----------|----------|-------------|
  71. | `SCRAPEMAPSAPI_API_KEY` | Yes | Your API key |
  72. | `SCRAPEMAPSAPI_BASE_URL` | No | Override the API base URL (default `https://api.scrapemapsapi.com`), e.g. `http://localhost:8000` |
  73. ## Development
  74. ```bash
  75. cd sdks/mcp
  76. uv venv && uv pip install -e ".[dev]"
  77. .venv/bin/pytest
  78. .venv/bin/ruff check .
  79. ```
  80. Test with the MCP Inspector:
  81. ```bash
  82. SCRAPEMAPSAPI_API_KEY=... SCRAPEMAPSAPI_BASE_URL=http://localhost:8000 uv run mcp dev dev_server.py
  83. ```
  84. ## License
  85. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.