Gmapsscraper Mcp

gmapsscraper MCP Server

[](https://www.npmjs.com/package/@gmapsscraper/mcp) [](./LICENSE)

MCP (Model Context Protocol) server for gmapsscraper.io — lets Claude, Cursor, Windsurf and any MCP client scrape Google Maps business data in plain conversation: names, addresses, phones, emails, websites, ratings, review counts, categories and coordinates.

> "Find 50 dentists in Chicago with their emails" → done, right in your AI chat.

Tools

| Tool | What it does | |---|---| | scrape_google_maps | Search Google Maps and return business leads (blocks until done, ~30–120s) | | start_scrape_job | Fire-and-forget version — returns a job id immediately | | get_scrape_results | Fetch results of a previously started job | | get_credits | Check remaining credit balance |

Each scrape costs 2 credits; multiple keywords in one call cost the same. Free tier: 10 credits (5 searches, no credit card) — get an API key at gmapsscraper.io/dashboard.

Setup

Claude Code

claude mcp add gmapsscraper -e GMAPSSCRAPER_API_KEY=your_key -- npx -y @gmapsscraper/mcp

Claude Desktop / Cursor / Windsurf

Add to your MCP config (claude_desktop_config.json, .cursor/mcp.json, etc.):

{
  "mcpServers": {
    "gmapsscraper": {
      "command": "npx",
      "args": ["-y", "@gmapsscraper/mcp"],
      "env": {
        "GMAPSSCRAPER_API_KEY": "your_key"
      }
    }
  }
}

Requires Node.js ≥ 18. The server runs locally over stdio and talks to the gmapsscraper.io API — no other infrastructure involved.

Example prompts

• "Scrape coffee shops in Austin TX with emails and give me a table"
• "Find plumbers in Miami, then draft a cold email for the top 5 by rating"
• "Start a scrape for 'wedding photographer in Denver CO', I'll check back later"
• "How many gmapsscraper credits do I have left?"

Data returned per business

title, address, phone, email, website, rating, reviews_count, category, latitude, longitude, google_maps_url, opening_hours

Results are capped at 100 businesses per response to keep your context tidy; the full CSV is always available from the dashboard.

Related

• 📦 Node.js SDK — npm install @gmapsscraper/sdk (this server is built on it)
• 🐍 Python SDK — pip install gmapsscraper-sdk
• 🤖 Claude agent skills
• 📘 API docs / llms.txt

License

[MIT](./LICENSE) © gmapsscraper.io

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: gmapsscraper
• Source: gmapsscraper/gmapsscraper-mcp
• License: MIT
• Homepage: https://gmapsscraper.io

Install and usage instructions live in the source repository linked above.