MCP server

gmaps.dev Official

dev.gmaps/gmaps

Checked 25 Oct 2026, 20:29 UTC · Connected to it and listed its tools

Find businesses by what they are and where they are, collect a whole city, and export the list.

Website

At a glance

Type

MCP server

Publisher

gmaps.dev (verified by the MCP Registry)

Status

Working at last check

Tools

18

Token cost

About 5,928 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

25 Oct 2026, 20:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.gmaps]
url = "https://api.gmaps.dev/mcp"

Gemini CLI

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

Cursor

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

VS Code

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

Antigravity

agy mcp add gmaps https://api.gmaps.dev/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"gmaps","server_url":"https://api.gmaps.dev/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"gmaps","server_url":"https://api.gmaps.dev/mcp"}

Tools

• cancel_collection ~232 tokens
  Stop a collection you no longer want. One that has not started yet stops at once and costs nothing. One already running keeps the places that have arrived and the credits they cost; the search in flight finishes, and nothing new starts. A collection that has already ended cannot be cancelled. Needs
• create_collection ~738 tokens
  Search a whole area, square by square, and collect up to maxPlaces of the places in it. Answers straight away with the collection, then works through the area in the background. Read the collection again to see how far it has got. Starting one costs nothing: each new place costs one credit as it arr
• create_export ~325 tokens
  Get a link to a collection's places as one file: csv, json or xlsx. The file has the places the collection holds now, even if it is still running. The link opens without an API key for 24 hours, so share it only with people who should see the file. Needs an API key. Costs no credits.
• create_webhook ~367 tokens
  Tell us where to POST when a collection ends, instead of asking us every few seconds whether it is done. The answer shows the signing secret once and never again. Store it, then check every request against it. The body carries counts and a link to the places, never the places themselves. Needs an AP
• delete_webhook Deletes data · ~211 tokens
  Stop sending to an endpoint and forget it, along with the record of what we sent there. To pause one instead, set enabled to false. That keeps the secret, so you do not have to change your code to turn it back on. Needs an API key and a paid plan. Costs no credits.
• get_attributions ~82 tokens
  List the projects credited by gmaps.dev, with their licenses and notices. No API key needed. Costs no credits.
• get_collection ~196 tokens
  See where a collection has got to: how much of the area is searched, how many places have arrived, and what it has cost so far. Read it again whenever you want an update. Needs an API key. Costs no credits.
• get_coverage ~549 tokens
  See how much of an area we have already searched for a term, when we last searched it, and how many places we have saved there. Use it to decide whether to collect again or just read the saved places. Needs an API key. Costs no credits and starts nothing.
• get_export ~199 tokens
  Read an export you made, with its download link, while the link still works. After 24 hours, or once the collection's places are deleted, it answers 404: make a new export from the collection. Needs an API key. Costs no credits.
• get_place ~168 tokens
  Read one saved place, by our id, Google's cid, Google's place ID, or a Google Maps link to it. It never searches: a place we have not saved answers 404, and searching its area with search_places brings it in. Needs an API key. Costs no credits.
• get_usage ~99 tokens
  See this month's credits: what your plan includes, what you have used, what is left today and this month, and the same totals for each API key. Needs an API key. Costs no credits.
• list_collections ~227 tokens
  Your collections, newest first, with the total so you know how many more there are. Filter by status to find the ones still running. Needs an API key. Costs no credits.
• list_webhook_deliveries ~251 tokens
  What we sent to one endpoint, newest first: which event, whether it arrived, how many tries it took, and what your server answered. This is where to look when an event never showed up. Kept for 7 days. Needs an API key and a paid plan. Costs no credits.
• list_webhooks ~115 tokens
  Every endpoint you have added, newest first, with whether it is still receiving events and why we stopped if it is not. Secrets are not shown again after the endpoint is created. Needs an API key and a paid plan. Costs no credits.
• quote_collection ~718 tokens
  See what collecting an area would cost before you start it: how much of it we have searched recently, how many places we have saved there (those cost nothing), how many searches are left to run, and the most it can cost in credits. Needs an API key. Costs no credits and starts nothing.
• search_places ~761 tokens
  Find places by what they are and where they are, such as bakeries in Curitiba. Places we saved from earlier searches come back at once, for free. If they do not fill `limit`, a collection starts to find the rest and the answer includes it: each new place costs one credit as it arrives, and it stops
• test_webhook ~280 tokens
  Send a "ping" to one of your endpoints now, so you can check your code reads it and the signature checks out before a real collection depends on it. Answers straight away with the delivery; read the deliveries list a moment later to see what your server said. Needs an API key and a paid plan. Costs
• update_webhook ~410 tokens
  Change which events an endpoint receives, rename it, or switch it off and on. This is how an endpoint comes back after we stopped sending to it: fix your server, then set enabled to true. The failure count starts again from zero. Whatever you leave out stays as it was. Needs an API key and a paid pl

Browse

• Website monitoring
• Spreadsheets
• Maps and places
• Travel and flights

Related MCP servers

• INITE Directory
  Businesses that confirmed their own facts at INITE, found by what they do and where.
• Orbylon
  Check that a business proved who it is, read what it sells, and order straight from it.
• Lyre Leads
  Every business of a kind in a city, from Google Maps, read from its website, with verified emails.
• Awning
  Find and book local services, classes and rentals; businesses set up and manage their pages.
• Relomote
  Search remote jobs by the country they hire from, and jobs with relocation or visa sponsorship.
• PestPin
  US pest control license check by number, licensed-company search by city, and cost planning ranges.
• Gaplessly Booking
  Find free times at Gaplessly businesses on a plan with AI booking, then get a link to book.
• Surfing Dog Search
  Find businesses an AI agent can message, book or buy from, and check what an agent can do on a site.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/dev.gmaps/gmaps.svg)](https://aptlynx.net/servers/dev.gmaps/gmaps)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents