<p align="center"> <a href="https://gmapsextractor.com"> <img src="logo.png" alt="G Maps Extractor" width="400"> </a> </p>

Google Maps Scraper MCP server

Give your AI agent live Google Maps business search, review, and photo data through one secure Model Context Protocol connection.

This repository is the public listing and manifest for the hosted G Maps Extractor MCP server. The server runs remotely, so there is no package to install and nothing to host locally.

• Website: gmapsextractor.com
• Product page: Google Maps Scraper MCP
• Get an API key: cloud.gmapsextractor.com
• MCP endpoint: https://cloud.gmapsextractor.com/api/mcp
• Transport: Streamable HTTP
• Authentication: Authorization: Bearer YOUR_API_KEY

What you can do

• Search businesses by keyword and location, including listing details such as names, addresses, phone numbers, websites, ratings, reviews, and photos.
• Retrieve public Google Maps reviews for reputation research and customer feedback analysis.
• Retrieve public business photos and image URLs for listing enrichment and visual audits.

Common workflows include prospecting research, local market analysis, competitor comparisons, CRM enrichment, reputation analysis, and listing audits.

Connect

Create an API key in the G Maps Extractor dashboard, keep it in a secure environment variable or secret store, and register the remote endpoint with your MCP client.

Claude Code

claude mcp add --transport http google-maps-scraper-mcp \
  https://cloud.gmapsextractor.com/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Cursor

Add this to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "google-maps-scraper-mcp": {
      "url": "https://cloud.gmapsextractor.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

VS Code

Add this to .vscode/mcp.json in your project:

{
  "servers": {
    "google-maps-scraper-mcp": {
      "type": "http",
      "url": "https://cloud.gmapsextractor.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Codex

Add this to ~/.codex/config.toml:

[mcp_servers.google-maps-scraper-mcp]
type = "http"
url = "https://cloud.gmapsextractor.com/api/mcp"

[mcp_servers.google-maps-scraper-mcp.headers]
Authorization = "Bearer YOUR_API_KEY"

Cline

Add this to your MCP settings:

{
  "mcpServers": {
    "google-maps-scraper-mcp": {
      "type": "streamableHttp",
      "url": "https://cloud.gmapsextractor.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Tools

search_google_maps

Search for businesses and places on Google Maps in real time.

Parameter	Type	Required	Description
q	string	Yes	Search query, such as coffee shops in New York
ll	string	No	Coordinates and zoom, such as @40.7128,-74.0060,11z
hl	string	No	Language code; defaults to en
gl	string	No	Country code; defaults to us
page	number	No	Page number; defaults to 1
extra	boolean	No	Include emails, social profiles, and extended details

get_place_reviews

Retrieve public reviews for a place using the fid returned by search_google_maps.

Parameter	Type	Required	Description
fid	string	Yes	Google Maps feature ID returned by a search
page	number	No	Page number; defaults to 1
max_page	number	No	Maximum number of pages to retrieve
sort_by	number	No	1 relevant, 2 newest, 3 highest rating, 4 lowest rating

get_place_photos

Retrieve public photos for a place using the fid returned by search_google_maps.

Parameter	Type	Required	Description
fid	string	Yes	Google Maps feature ID returned by a search
page	number	No	Page number; defaults to 1
max_page	number	No	Maximum number of pages to retrieve

Example prompts

• “Find the top-rated coffee shops in Portland and return their website, phone number, rating, and review count.”
• “Get the newest Google Maps reviews for this place and summarize the recurring customer complaints.”
• “Retrieve public photos for these restaurant FIDs and identify locations with limited visual content.”
• “Compare visible listing signals for dentists in Austin and group the results by rating.”

Authentication and usage

Every request must include your G Maps Extractor API key:

Authorization: Bearer YOUR_API_KEY

Do not commit a real API key to this repository or any client configuration. New accounts can start with the available free monthly requests; higher-volume usage follows the plan attached to the key.

About this repository

This is a public discovery, configuration, and documentation repository. It contains:

• server.json for MCP Registry-compatible server metadata
• .mcp.json as a ready-to-customize client configuration
• llms-install.md with concise installation instructions for AI agents
• product icons and branding

The hosted MCP implementation remains at https://cloud.gmapsextractor.com/api/mcp.

License

MIT