Skip to content
MCP server

gmaps.dev

Find businesses by type and area, collect a whole city of places and export them

Install
Pricing
Freemium
Platforms
API, Web
Runs
Remotely
Version
1.0.0
Listing updated
1 day ago

About gmaps.dev

gmaps.dev is a freemium MCP server for maps and travel. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://api.gmaps.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "gmaps": {
      "url": "https://api.gmaps.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (18)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium, from $24 a month

Free 1,000 credits/month; Starter $24, Pro $69, Scale $269 per month

Prices change. Check gmaps.dev before you buy.

gmaps.dev 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 to gmaps.dev

  1. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  2. MCP server that lets AI agents search, scrape and interact with web pages

    • 3 tools
    • Remote
    • Freemium
    • 7.8K GitHub stars
    • Web search and scraping
  3. SearXNG Search

    MCP server

    MCP server for web search and page reading through a SearXNG instance

    Runs locally
    • 3 tools
    • Open source
    • 1.4K GitHub stars
    • Web search and scraping
  4. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  5. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data
  6. Find, enrich and score B2B leads and run outreach sequences from an AI assistant

    • 31 tools
    • Remote
    • Freemium
    • 1 GitHub star
    • Sales and CRM