<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](https://modelcontextprotocol.io/) 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](https://gmapsextractor.com)
- Product page: [Google Maps Scraper MCP](https://gmapsextractor.com/google-maps-scraper-mcp)
- Get an API key: [cloud.gmapsextractor.com](https://gmapsextractor.com/google-maps-scraper-mcp)
- 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](https://cloud.gmapsextractor.com), keep it in a secure environment variable or secret store, and register the remote endpoint with your MCP client.

### Claude Code

```bash
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:

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

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

```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:

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

```http
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](LICENSE)