# gmaps.dev

> gmaps.dev is a freemium MCP server for maps and travel. Find businesses by type and area, collect a whole city of places and export them. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $24 a month
- **Platforms:** API, Web
- **Website:** https://gmaps.dev/docs/en/mcp
- **MCP Registry name:** dev.gmaps/gmaps
- **Categories:** maps and travel, web search and scraping, sales and CRM
- **Listing updated:** 2026-11-16

## About

gmaps.dev wraps its places API in 18 MCP tools. An agent starts with search_places, which answers immediately from places already saved, free of charge. If the requested limit is not filled, a background collection searches the area square by square and the new places cost one credit each. For a whole city, quote_collection shows the maximum cost before create_collection is called with a maxPlaces cap.

Results leave the agent's context through create_export, which returns a link to a CSV, JSON or XLSX file that works for 24 hours. Webhook tools (paid plans) notify your own server when a collection ends, and emails for new places cost one extra credit each on paid plans.

The docs are blunt about permissions: the connection is not read-only, and it can start and cancel collections, create exports and manage webhooks, using the signed-in account's credits. There are no per-tool permissions. Sign-in is OAuth, with a device-code flow for agents without a browser, or an API key header.

## Features

- **Saved-place search:** search_places answers free from places already saved, marked cached.
- **City-wide collection:** create_collection searches an area square by square up to a place limit.
- **Cost quote:** quote_collection shows the most a collection could cost before it starts.
- **File exports:** Exports to CSV, JSON or XLSX come as a link valid for 24 hours.
- **Webhooks:** Paid plans can be notified when a collection ends.
- **Usage tracking:** get_usage shows credits used and left, today and this month.

## Good for

- Build a list of bike shops or other local businesses in a city
- Check how much of an area has been searched already
- Export a collected list to a spreadsheet
- Notify a pipeline when a collection finishes
- Look up a place from a Maps link or place ID

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http gmaps https://api.gmaps.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.gmaps.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "gmaps": {
      "url": "https://api.gmaps.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "gmaps": {
      "type": "http",
      "url": "https://api.gmaps.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "gmaps": {
      "serverUrl": "https://api.gmaps.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "gmaps": {
      "type": "http",
      "url": "https://api.gmaps.dev/mcp"
    }
  }
}
```

## Tools

- `search_places`: Finds places by type and area, answering at once from saved places.
- `get_place`: Reads one saved place.
- `get_collection`: Shows a collection's progress and cost.
- `list_collections`: Lists your collections, newest first.
- `quote_collection`: Shows the maximum cost of a collection without starting it.
- `create_collection`: Searches a whole area up to maxPlaces places.
- `cancel_collection`: Stops a collection.
- `get_coverage`: Shows how much of an area has been searched.
- `create_export`: Returns a link to a collection's places as CSV, JSON or XLSX.
- `get_export`: Reads an export again while its link works.
- `get_usage`: Shows credits used and left.
- `create_webhook`: Adds an endpoint called when a collection ends.
- `list_webhooks`: Lists webhook endpoints.
- `update_webhook`: Changes or toggles an endpoint.
- `test_webhook`: Sends a test event to an endpoint.
- `list_webhook_deliveries`: Shows what was sent to an endpoint and the reply.
- `delete_webhook`: Removes an endpoint and its delivery log.
- `get_attributions`: Lists the open-source projects it builds on.

## FAQ

### What does it cost?

Plans run Free (1,000 credits a month), Starter $24, Pro $69 and Scale $269 a month. A new place found by a collection costs one credit; saved places are free.

### Can the agent spend my credits unprompted?

Only search_places and create_collection can spend credits, but the connection has the same access as a normal API key.

### How do I disconnect it?

Revoke the app's key under API keys; removing the server from your AI app does not revoke it.

### What happens when credits run out?

Searches still return saved places for free; new collection stops until renewal or a credit pack.

### Is gmaps.dev free?

gmaps.dev has a free plan, with paid plans for more usage or features. Paid plans start at $24 a month.

### How do I add gmaps.dev to Claude Code?

Run this command in your terminal: claude mcp add --transport http gmaps https://api.gmaps.dev/mcp

### What are the best alternatives to gmaps.dev?

The closest alternatives to gmaps.dev are Scrapling MCP Server, Firecrawl MCP Server, SearXNG Search, Calven and CompanyData.

## Alternatives

- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Firecrawl MCP Server](https://ai-powered.com/mcp/firecrawl-mcp-server): Firecrawl MCP Server is a freemium MCP server for web search and scraping.
- [SearXNG Search](https://ai-powered.com/mcp/searxng-search): SearXNG Search is an open-source MCP server for web search and scraping.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MisarReach MCP Server](https://ai-powered.com/mcp/misarreach-mcp-server): MisarReach MCP Server is a freemium MCP server for sales and crm.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [AI-Powered directory](https://ai-powered.com/mcp/ai-powered-directory): AI-Powered directory is a free MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/gmaps-dev
