gmapsscraper MCP server
✓ VerifiedScrape Google Maps business data including names, phones, emails, and websites directly through an AI chat interface.
Also known as gmapsscraper/gmapsscraper-mcp, gmapsscraper-mcp, @gmapsscraper/mcp
- Stars
- 3
- Tools
- 4
- Downloads, 30 days
- 145
- Latest version
- 0.1.1
- Last commit
- Aug 4, 2026
- License
- MIT
What is gmapsscraper MCP?
gmapsscraper is an MCP server. Scrape Google Maps business data including names, phones, emails, and websites directly through an AI chat interface. It exposes 4 tools, such as scrape_google_maps, start_scrape_job, get_scrape_results.
Summary generated from the project's README
About gmapsscraper MCP server
Extracting business leads from Google Maps through an AI chat interface is what this MCP server enables for developers and researchers. By connecting to the gmapsscraper.io API, users can request specific datasets including business names, phone numbers, emails, websites, ratings, and coordinates. The server runs locally via stdio and integrates with clients like Claude Desktop, Cursor, and Windsurf using an API key.
Users can choose between different execution methods depending on their needs. The scrape_google_maps tool performs a synchronous search that blocks until completion, while start_scrape_job allows for a fire-and-forget approach by returning a job id. You can manage your workflow using get_scrape_results to fetch data from previous jobs or get_credits to monitor your balance. Each search consumes 2 credits, and a free tier provides 10 credits to get started without a credit card.
What you can do with it
- 1Generate targeted lead listsAsk the AI to find specific business types in a certain city and return their contact details in a table.
- 2Automate cold outreach preparationIdentify high-rated service providers and immediately use their information to draft personalized messages.
- 3Manage long-running data collectionInitiate a large scraping task and retrieve the results later using a job identifier.
- 4Monitor API usage and balanceCheck how many remaining credits are available on your account to ensure upcoming searches will succeed.
Written from the project's README. Every use case is checked against a quote from it.
How to install gmapsscraper MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall gmapsscraper MCP in Claude Code
$ claude mcp add --env 'GMAPSSCRAPER_API_KEY=<YOUR_GMAPSSCRAPER_API_KEY>' gmapsscraper-mcp -- npx -y @gmapsscraper/mcpInstall gmapsscraper MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"gmapsscraper-mcp": {
"command": "npx",
"args": [
"-y",
"@gmapsscraper/mcp"
],
"env": {
"GMAPSSCRAPER_API_KEY": "<YOUR_GMAPSSCRAPER_API_KEY>"
}
}
}
}Install gmapsscraper MCP in VS Code
.vscode/mcp.json
{
"servers": {
"gmapsscraper-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@gmapsscraper/mcp"
],
"env": {
"GMAPSSCRAPER_API_KEY": "<YOUR_GMAPSSCRAPER_API_KEY>"
}
}
}
}Install gmapsscraper MCP in VS Code CLI
$ code --add-mcp '{"name":"gmapsscraper-mcp","type":"stdio","command":"npx","args":["-y","@gmapsscraper/mcp"],"env":{"GMAPSSCRAPER_API_KEY":"<YOUR_GMAPSSCRAPER_API_KEY>"}}'Install gmapsscraper MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"gmapsscraper-mcp": {
"command": "npx",
"args": [
"-y",
"@gmapsscraper/mcp"
],
"env": {
"GMAPSSCRAPER_API_KEY": "<YOUR_GMAPSSCRAPER_API_KEY>"
}
}
}
}Install gmapsscraper MCP in Codex
$ codex mcp add gmapsscraper-mcp --env 'GMAPSSCRAPER_API_KEY=<YOUR_GMAPSSCRAPER_API_KEY>' -- npx -y @gmapsscraper/mcpInstall gmapsscraper MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.gmapsscraper-mcp] command = "npx" args = ["-y", "@gmapsscraper/mcp"] [mcp_servers.gmapsscraper-mcp.env] GMAPSSCRAPER_API_KEY = "<YOUR_GMAPSSCRAPER_API_KEY>"
Install gmapsscraper MCP in Gemini CLI
$ gemini mcp add -s user -e 'GMAPSSCRAPER_API_KEY=<YOUR_GMAPSSCRAPER_API_KEY>' gmapsscraper-mcp npx -- -y @gmapsscraper/mcpInstall gmapsscraper MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"gmapsscraper-mcp": {
"command": "npx",
"args": [
"-y",
"@gmapsscraper/mcp"
],
"env": {
"GMAPSSCRAPER_API_KEY": "<YOUR_GMAPSSCRAPER_API_KEY>"
}
}
}
}gmapsscraper MCP tools 4
Detected from the READMEscrape_google_mapsstart_scrape_jobget_scrape_resultsget_credits
Configuration
GMAPSSCRAPER_API_KEYRequiredSecretAPI key from https://gmapsscraper.io/dashboard (free tier: 10 credits)
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablegmapsscraper/gmapsscraper-mcp is public and reachablegithub.com/gmapsscraper/gmapsscraper-mcp ↗Pass
- Package names this repository as its source@gmapsscraper/mcp names gmapsscraper/gmapsscraper-mcp as sourcenpmjs.com/package/@gmapsscraper/mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-08-04github.com/gmapsscraper/gmapsscraper-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @gmapsscraper/mcpPass
- No critical advisory in the package or its dependencies100 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model4 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubgmapsscraper 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
| 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"
}
}
}
}
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
- 📦 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
gmapsscraper MCP questions
How do I add gmapsscraper MCP to Claude Code?
Run claude mcp add --env 'GMAPSSCRAPER_API_KEY=<YOUR_GMAPSSCRAPER_API_KEY>' gmapsscraper-mcp -- npx -y @gmapsscraper/mcp in your terminal. Add --scope user to make it available in every project.
How do I add gmapsscraper MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does gmapsscraper MCP provide?
It exposes 4 tools, including scrape_google_maps, start_scrape_job, get_scrape_results, get_credits.
How much does a scrape cost?
Each scrape costs 2 credits, regardless of whether you use multiple keywords in a single call.
Is there a free tier available?
Yes, the free tier provides 10 credits, which allows for 5 searches without requiring a credit card.
How many results can I get in a single response?
Responses are limited to 100 businesses to maintain a tidy context window.