mcpField
G
gmapsscraper

gmapsscraper

Local
gmapsscraper.ioBusiness & Marketing3Updated 12w ago
RepositoryVisit website

About gmapsscraper

gmapsscraper is an MCP server for collecting Google Maps business leads, aimed at sales and research workflows. It returns contact details and business metrics, with both synchronous searches and background jobs.

Key features

  1. 01Search Google Maps for businesses
  2. 02Return contact and rating details
  3. 03Run scrapes as background jobs
  4. 04Retrieve job results and credit balance

Use cases

  1. 01Build prospect lists by location and category
  2. 02Find business emails and websites
  3. 03Start a scrape and collect results later

MCP support

Exposes Google Maps search, background job, result retrieval, and credit-check tools to MCP clients. It runs locally over stdio and calls the gmapsscraper.io API.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "io-gmapsscraper": {
      "command": "npx",
      "args": [
        "-y",
        "@gmapsscraper/mcp"
      ],
      "env": {
        "GMAPSSCRAPER_API_KEY": "<GMAPSSCRAPER_API_KEY>"
      }
    }
  }
}
Run commandnpx -y @gmapsscraper/mcp
Environment variables to set
GMAPSSCRAPER_API_KEYSecretAPI key from https://gmapsscraper.io/dashboard (free tier: 10 credits)

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@gmapsscraper/mcp0.1.1

Tools

4

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
langstringNoISO 639-1 result language, e.g. "en", "es", "de".
depthintegerNo1-2, higher returns more results at the same credit cost.
emailbooleanNoAlso crawl business websites to extract contact emails (recommended for lead generation / cold outreach).
radiusintegerNoSearch radius in meters (default 20000).
keywordsarrayYesSearch queries including a location, e.g. ["dentist in Chicago IL"]. Multiple related keywords cost the same 2 credits.
max_wait_secondsintegerNoHow long to wait for the scrape to finish before handing back a job id to poll.

Details

From the project README

gmapsscraper MCP Server

npm version 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

ToolWhat it does
scrape_google_mapsSearch Google Maps and return business leads (blocks until done, ~30–120s)
start_scrape_jobFire-and-forget version — returns a job id immediately
get_scrape_resultsFetch results of a previously started job
get_creditsCheck 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"
      }
    }
  }
}
Cursor Directory / Open Plugins

Installing from a plugin directory uses the bundled mcp.json, which deliberately ships without an env block — the Open Plugins spec only expands ${PLUGIN_ROOT} and ${PLUGIN_DATA}, so a secret placeholder would be passed through literally and the server would fail to authenticate.

Set the key in your own environment before starting the client:

# macOS / Linux — add to ~/.zshrc or ~/.bashrc
export GMAPSSCRAPER_API_KEY=your_key

# Windows PowerShell
setx GMAPSSCRAPER_API_KEY "your_key"

Restart the client afterwards so it picks up the variable. If a scrape returns an auth error, run get_credits first — it fails fast and confirms whether the key is being seen.

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

License

MIT © gmapsscraper.io

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.