Gmapsscraper

io.gmapsscraperPublished by gmapsscraper.iov0.1.1Updated Oct 24, 2026

Scrape Google Maps business data from any MCP client — names, phones, emails, websites, ratings.

VerifiedSTDIODesktop onlyWeb Search & ScrapingBusiness & Commerce

Overview

AI-generated overview

Lets an assistant scrape Google Maps business data such as names, phones, emails, websites and ratings.

What you can do
Lets an assistant scrape Google Maps business data through gmapsscraper.io, returning fields such as name, address, phone, email, website, rating, review count, category and coordinates. Tools include a blocking scrape, a fire-and-forget job starter, a results fetcher for earlier jobs, and a credit balance check. Responses are capped at 100 businesses each.
When to use it
Useful when you want to gather lists of Google Maps businesses inside a chat, such as lead generation, market research, or compiling local business lists; for occasional lookups of a single business, Google Maps itself is simpler.
Requirements
Runs locally over stdio and needs Node.js 18 or later. Requires the GMAPSSCRAPER_API_KEY environment variable, obtainable from the gmapsscraper.io dashboard (free tier of 10 credits), plus network access to the gmapsscraper.io API.
Before you install
Requires the GMAPSSCRAPER_API_KEY secret. Each scrape costs 2 credits, and further credits may involve payment. Scrape requests and results go to the third-party gmapsscraper.io service, and returned data can include business contact details such as emails, so consider privacy and marketing rules before use.

Installation

In SourceWeft

  1. Open Gmapsscraper in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

bash
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.):

json
{  "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:

bash
# macOS / Linux — add to ~/.zshrc or ~/.bashrcexport GMAPSSCRAPER_API_KEY=your_key
powershell
# Windows PowerShellsetx 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

Source: README.md at commit d439400

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts