English Français العربية

io.gmapsscraper/mcp

Official registry Search and web

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

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @gmapsscraper/mcp
Claude Code 
claude mcp add io-gmapsscraper-mcp -e 'GMAPSSCRAPER_API_KEY=<your gmapsscraper_api_key>' -- npx -y @gmapsscraper/mcp@0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "io-gmapsscraper-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@gmapsscraper/mcp@0.1.1"
            ],
            "env": {
                "GMAPSSCRAPER_API_KEY": "<your gmapsscraper_api_key>"
            }
        }
    }
}

Environment variables

  • GMAPSSCRAPER_API_KEY required secret API key from https://gmapsscraper.io/dashboard (free tier: 10 credits)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. gmapsscraper MCP Server
  2. Tools
  3. Setup
  4. Example prompts
  5. Data returned per business
  6. Related
  7. License

gmapsscraper MCP Server

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.

License

MIT © gmapsscraper.io

Frequently asked questions

What is io.gmapsscraper/mcp?

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

How do I install io.gmapsscraper/mcp?

It runs on your machine. In Claude Code: claude mcp add io-gmapsscraper-mcp -e 'GMAPSSCRAPER_API_KEY=<your gmapsscraper_api_key>' -- npx -y @gmapsscraper/mcp@0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.gmapsscraper/mcp need an API key?

Yes. It expects GMAPSSCRAPER_API_KEY, which you set in its configuration.

Is io.gmapsscraper/mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.gmapsscraper/mcp?

It is published by gmapsscraper. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.