Google Maps MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on Google Maps: 18 typed functions through one MCP server. No Google Maps API key needed.
- Site
- google.com
- Functions
- 18
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Google Maps alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/google_mapsOne MCP server for Google Maps and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.
Functions
Open a function to see its arguments, what it returns and how to call it.
geocodeAddressA street address or place name in, coordinates and the matching Google Maps place out.Arguments
Name Type Required addressstringYes Returns
GeocodeAddressResultinterface GeocodeAddressResult { featureId: string; name: string; formattedAddress: string; coordinates: { lat: number; lng: number } | null; warnings?: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/google_maps/geocodeAddressCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.google_maps.geocodeAddress({ address: "Seattle, WA" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.google_maps.geocodeAddress({"address": "Seattle, WA"}))curl -X POST https://api.bowmark.ai/v1/sites/google_maps/geocodeAddress \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"address":"Seattle, WA"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.google_maps.geocodeAddress({ address: "Seattle, WA" });getDirectionsRoute between two places, the site's own trip total (distance, duration, traffic-aware for driving) and the turn-by-turn instructions, by car, on…Arguments
Name Type Required originstringYes destinationstringYes mode"driving" | "walking" | "transit"No waypointsstring[]No Returns
GetDirectionsResultinterface DirectionsStep { instruction: string; distance: string; duration: string; transit?: { line: string; vehicle?: string; headsign?: string; boardStop: string; alightStop: string; departureTime?: string; arrivalTime?: string; numStops?: number; }; } interface GetDirectionsResult { distance: string; duration: string; distanceMeters: number; durationSeconds: number; steps: DirectionsStep[]; numTransfers?: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/google_maps/getDirectionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.google_maps.getDirections({ origin: "Space Needle, Seattle, WA", destination: "Analog Coffee, Seattle, WA" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.google_maps.getDirections({ "origin": "Space Needle, Seattle, WA", "destination": "Analog Coffee, Seattle, WA" }))curl -X POST https://api.bowmark.ai/v1/sites/google_maps/getDirections \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"origin":"Space Needle, Seattle, WA","destination":"Analog Coffee, Seattle, WA"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.google_maps.getDirections({ origin: "Space Needle, Seattle, WA", destination: "Analog Coffee, Seattle, WA" });getPlaceGet detailed business information including hours of operation and current open/closed status.Arguments
Name Type Required querystringYes serviceOptionsbooleanGranted; never required.No Returns
GetPlaceResultinterface GetPlaceResult { featureId: string; name: string; url: string; address: string; coordinates: { lat: number; lng: number } | null; categories: string[]; neighborhood?: string; phone?: string; website?: string; rating?: number; reviewCount?: number; hours?: { day: string; hours: string[] }[]; openStatus?: string; accessibility?: string[]; // Positive evidence only ("Dine-in", "Takeout", "Delivery", "Drive-through"): // a missing option is unknown, never "does not offer". serviceOptions?: string[]; orderOnlineUrl?: string; warnings?: string[]; businessStatus?: "closed"; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/google_maps/getPlaceCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.google_maps.getPlace({ query: "Space Needle, Seattle, WA" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.google_maps.getPlace({"query": "Space Needle, Seattle, WA"}))curl -X POST https://api.bowmark.ai/v1/sites/google_maps/getPlace \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"Space Needle, Seattle, WA"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.google_maps.getPlace({ query: "Space Needle, Seattle, WA" });getPopularTimesThe "popular times" histogram for a place.Arguments
Name Type Required querystringYes Returns
PopularTimesResultinterface PopularTimesDay { day: number; hours: { hour: number; percent: number }[]; } interface PopularTimesResult { byDay: PopularTimesDay[]; liveNow?: { percent: number }; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/google_maps/getPopularTimesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.google_maps.getPopularTimes({ query: "Space Needle, Seattle, WA" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.google_maps.getPopularTimes({"query": "Space Needle, Seattle, WA"}))curl -X POST https://api.bowmark.ai/v1/sites/google_maps/getPopularTimes \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"Space Needle, Seattle, WA"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.google_maps.getPopularTimes({ query: "Space Needle, Seattle, WA" });listMyContributionsThe reviews, photos, answers and edits the signed-in caller has contributed, with their view counts.Arguments
None.
Returns
MyContributionsResultinterface ContributionType { label: string; count: number; viewCount?: number; } interface MyContributionsResult { name: string; bio?: string; level?: number; points?: number; pointsToNextLevel?: string; contributions: ContributionType[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/google_maps/listMyContributionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.google_maps.listMyContributions();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.google_maps.listMyContributions())curl -X POST https://api.bowmark.ai/v1/sites/google_maps/listMyContributions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.google_maps.listMyContributions();listPhotosThe photos Google Maps shows in a place's gallery panel.Arguments
Name Type Required featureIdstringYes Returns
Photo[]interface Photo { url: string; width: number; height: number; takenAt?: string; source?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/google_maps/listPhotosCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.google_maps.listPhotos({ featureId: "0x54901532347e3bc7:0x9d0ae45cc1e8af37" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.google_maps.listPhotos({"featureId": "0x54901532347e3bc7:0x9d0ae45cc1e8af37"}))curl -X POST https://api.bowmark.ai/v1/sites/google_maps/listPhotos \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"featureId":"0x54901532347e3bc7:0x9d0ae45cc1e8af37"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.google_maps.listPhotos({ featureId: "0x54901532347e3bc7:0x9d0ae45cc1e8af37" });listRelatedPlacesOther businesses Google Maps lists "At this place".Arguments
Name Type Required querystringYes Returns
RelatedPlace[]interface RelatedPlace { featureId: string; name: string; coordinates: { lat: number; lng: number } | null; categories: string[]; rating?: number; reviewCount?: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/google_maps/listRelatedPlacesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.google_maps.listRelatedPlaces({ query: "Space Needle, Seattle, WA" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.google_maps.listRelatedPlaces({"query": "Space Needle, Seattle, WA"}))curl -X POST https://api.bowmark.ai/v1/sites/google_maps/listRelatedPlaces \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"Space Needle, Seattle, WA"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.google_maps.listRelatedPlaces({ query: "Space Needle, Seattle, WA" });listReviewsThe reviews Google Maps shows for a business, each with author, star rating, review text, the site's own relative date AND an ISO posting time, the…Arguments
Name Type Required querystring/maps/search/ link). featureId skips the resolve hop.No featureIdstringNo urlstringNo sort"relevant" | "newest" | "highest" | "lowest"Default 100). No sign-in needed.No limitnumberNo pagedbooleanNo Returns
ListReviewsResultinterface Review { author: string; authorId?: string; rating: number; text: string; relativeDate?: string; // "3 months ago" id?: string; isoDate?: string; language?: string; link?: string; authorUrl?: string; authorPhoto?: string; authorReviewCount?: number; authorPhotoCount?: number; authorIsLocalGuide?: boolean; photos?: { url: string; caption?: string }[]; details?: Record<string, string | number>; // "Food": 5, "Noise level": "Moderate noise" ownerReply?: { text: string; relativeDate?: string }; // the business's own reply (feed only) } interface ListReviewsResult { reviews: Review[]; reviewCount?: number; // the site's own TOTAL, reviews is a slice of it featureId?: string; ratingHistogram?: { 1: number; 2: number; 3: number; 4: number; 5: number }; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/google_maps/listReviewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.google_maps.listReviews({ query: "Space Needle, Seattle, WA" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.google_maps.listReviews({"query": "Space Needle, Seattle, WA"}))curl -X POST https://api.bowmark.ai/v1/sites/google_maps/listReviews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"Space Needle, Seattle, WA"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.google_maps.listReviews({ query: "Space Needle, Seattle, WA" });listSavedPlacesThe places the signed-in caller saved.Arguments
None.
Returns
ListSavedPlacesResultinterface SavedPlace { listName: string; featureId: string; name?: string; note?: string; } interface ListSavedPlacesResult { lists: { name: string; places: SavedPlace[] }[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/google_maps/listSavedPlacesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.google_maps.listSavedPlaces();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.google_maps.listSavedPlaces())curl -X POST https://api.bowmark.ai/v1/sites/google_maps/listSavedPlaces \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.google_maps.listSavedPlaces();resolvePlaceUrlA Google Maps link somebody pasted.Arguments
Name Type Required urlstringYes Returns
GoogleMapsPlaceinterface GoogleMapsPlace { featureId: string; name?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/google_maps/resolvePlaceUrlCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.google_maps.resolvePlaceUrl({ url: "<url>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.google_maps.resolvePlaceUrl({"url": "<url>"}))curl -X POST https://api.bowmark.ai/v1/sites/google_maps/resolvePlaceUrl \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"url":"<url>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.google_maps.resolvePlaceUrl({ url: "<url>" });reverseGeocodeA point in, the Plus Code and locality Google Maps shows for it out, the same string a person sees when they drop a pin ("JMC2+57W Seattle…Arguments
Name Type Required latnumberYes lngnumberYes Returns
ReverseGeocodeResultinterface ReverseGeocodeResult { formatted: string; plusCode: string; locality: string; dms: string; coordinates: { lat: number; lng: number }; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/google_maps/reverseGeocodeCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.google_maps.reverseGeocode({ lat: 47.6205, lng: -122.3493 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.google_maps.reverseGeocode({"lat": 47.6205, "lng": -122.3493}))curl -X POST https://api.bowmark.ai/v1/sites/google_maps/reverseGeocode \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"lat":47.6205,"lng":-122.3493}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.google_maps.reverseGeocode({ lat: 47.6205, lng: -122.3493 });searchNearbySearchPlaces anchored to a POINT instead of resolved from the query text.Arguments
Name Type Required querystringYes latnumberYes lngnumberYes Returns
SearchPlacesResult[]interface SearchPlacesResult { featureId: string; name: string; url: string; address: string; coordinates: { lat: number; lng: number } | null; categories: string[]; rating?: number; reviewCount?: number; hours?: { day: string; hours: string[] }[]; openStatus?: string; placeId?: string; // Places API id, "ChIJ…" cid?: string; website?: string; phone?: string; description?: string; image?: string; reviewsUrl?: string; streetAddress?: string; borough?: string; city?: string; postalCode?: string; state?: string; countryCode?: string; timezone?: string; orderOnlineUrl?: string; businessStatus?: "closed"; // absence never means open // Always present; null / [] when Google's record carries nothing. claimed: boolean; // false when Google shows "Claim this business" priceRange: string | null; orderUrls: { url: string; platform: string }[]; // platform "Google" for Google's own link tags: string[]; // "Dine-in", "Takeout", "Delivery", … positive evidence only about: string | null; // "Accessibility: Wheelchair accessible entrance, …" streetAddressSupplement: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/google_maps/searchNearbyCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.google_maps.searchNearby({ query: "coffee", lat: 47.6205, lng: -122.3493 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.google_maps.searchNearby({"query": "coffee", "lat": 47.6205, "lng": -122.3493}))curl -X POST https://api.bowmark.ai/v1/sites/google_maps/searchNearby \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"coffee","lat":47.6205,"lng":-122.3493}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.google_maps.searchNearby({ query: "coffee", lat: 47.6205, lng: -122.3493 });searchPlacesSearch for places by name or category, returning hours and open status.Arguments
Name Type Required querystring?cid= or maps.app.goo.gl link returns that one place.No urlstringNo Returns
SearchPlacesResult[]interface SearchPlacesResult { featureId: string; name: string; url: string; address: string; coordinates: { lat: number; lng: number } | null; categories: string[]; rating?: number; reviewCount?: number; hours?: { day: string; hours: string[] }[]; openStatus?: string; placeId?: string; // Places API id, "ChIJ…" cid?: string; website?: string; phone?: string; description?: string; image?: string; reviewsUrl?: string; streetAddress?: string; borough?: string; city?: string; postalCode?: string; state?: string; countryCode?: string; timezone?: string; orderOnlineUrl?: string; businessStatus?: "closed"; // absence never means open // Always present; null / [] when Google's record carries nothing. claimed: boolean; // false when Google shows "Claim this business" priceRange: string | null; orderUrls: { url: string; platform: string }[]; // platform "Google" for Google's own link tags: string[]; // "Dine-in", "Takeout", "Delivery", … positive evidence only about: string | null; // "Accessibility: Wheelchair accessible entrance, …" streetAddressSupplement: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/google_maps/searchPlacesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.google_maps.searchPlaces({ query: "coffee shops in seattle wa" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.google_maps.searchPlaces({"query": "coffee shops in seattle wa"}))curl -X POST https://api.bowmark.ai/v1/sites/google_maps/searchPlaces \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"coffee shops in seattle wa"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.google_maps.searchPlaces({ query: "coffee shops in seattle wa" });suggestPlacesGoogle Maps' own autocomplete for a half-typed query.Arguments
Name Type Required querystringYes Returns
string[]HTTP endpoint
POST https://api.bowmark.ai/v1/sites/google_maps/suggestPlacesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.google_maps.suggestPlaces({ query: "analog coffee seattle" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.google_maps.suggestPlaces({"query": "analog coffee seattle"}))curl -X POST https://api.bowmark.ai/v1/sites/google_maps/suggestPlaces \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"analog coffee seattle"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.google_maps.suggestPlaces({ query: "analog coffee seattle" });
addMissingPlaceAdd a business Google Maps does not list yet.Arguments
Name Type Required namestringYes addressstringYes categorystringNo phonestringNo websitestringNo Returns
AddMissingPlaceResultinterface AddMissingPlaceResult { submitted: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/google_maps/addMissingPlaceCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.google_maps.addMissingPlace({ name: "<name>", address: "<address>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.google_maps.addMissingPlace({"name": "<name>", "address": "<address>"}))curl -X POST https://api.bowmark.ai/v1/sites/google_maps/addMissingPlace \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"name":"<name>","address":"<address>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.google_maps.addMissingPlace({ name: "<name>", address: "<address>" });savePlaceSave a place to one of the signed-in person's own lists.Arguments
Name Type Required featureIdstringYes Returns
SavePlaceResultinterface SavePlaceResult { saved: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/google_maps/savePlaceCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.google_maps.savePlace({ featureId: "<featureId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.google_maps.savePlace({"featureId": "<featureId>"}))curl -X POST https://api.bowmark.ai/v1/sites/google_maps/savePlace \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"featureId":"<featureId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.google_maps.savePlace({ featureId: "<featureId>" });suggestPlaceEditSend Google a correction about a place.Arguments
Name Type Required featureIdstringYes kind"wrong_info" | "closed" | "other"Yes detailsstringYes Returns
SuggestPlaceEditResultinterface SuggestPlaceEditResult { submitted: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/google_maps/suggestPlaceEditCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.google_maps.suggestPlaceEdit({ featureId: "<featureId>", kind: "wrong_info", details: "<details>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.google_maps.suggestPlaceEdit({ "featureId": "<featureId>", "kind": "wrong_info", "details": "<details>" }))curl -X POST https://api.bowmark.ai/v1/sites/google_maps/suggestPlaceEdit \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"featureId":"<featureId>","kind":"wrong_info","details":"<details>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.google_maps.suggestPlaceEdit({ featureId: "<featureId>", kind: "wrong_info", details: "<details>" });writeReviewPost a star rating and review text on a place, as the signed-in person.Arguments
Name Type Required placeIdstringYes ratingnumberYes textstringNo Returns
WriteReviewResultinterface WriteReviewResult { posted: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/google_maps/writeReviewCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.google_maps.writeReview({ placeId: "<placeId>", rating: 1 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.google_maps.writeReview({"placeId": "<placeId>", "rating": 1}))curl -X POST https://api.bowmark.ai/v1/sites/google_maps/writeReview \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"placeId":"<placeId>","rating":1}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.google_maps.writeReview({ placeId: "<placeId>", rating: 1 });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/google_maps/<function> - OpenAPI
/v1/sites/google_maps/openapi.json