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.

Functions
18
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just Google Maps

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_maps
Every site

One 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/mcp
Set it up in your client

Both 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.

Read 14
  • geocodeAddressA street address or place name in, coordinates and the matching Google Maps place out.

    Arguments

    NameTypeRequired
    addressstringYes

    Returns GeocodeAddressResult

    interface 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/geocodeAddress

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    originstringYes
    destinationstringYes
    mode"driving" | "walking" | "transit"No
    waypointsstring[]No

    Returns GetDirectionsResult

    interface 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/getDirections

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    querystringYes
    serviceOptionsboolean
    Granted; never required.
    No

    Returns GetPlaceResult

    interface 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/getPlace

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.google_maps.getPlace({ query: "Space Needle, Seattle, WA" });
  • getPopularTimesThe "popular times" histogram for a place.

    Arguments

    NameTypeRequired
    querystringYes

    Returns PopularTimesResult

    interface 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/getPopularTimes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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 MyContributionsResult

    interface 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/listMyContributions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.google_maps.listMyContributions();
  • listPhotosThe photos Google Maps shows in a place's gallery panel.

    Arguments

    NameTypeRequired
    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/listPhotos

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.google_maps.listPhotos({ featureId: "0x54901532347e3bc7:0x9d0ae45cc1e8af37" });
  • listRelatedPlacesOther businesses Google Maps lists "At this place".

    Arguments

    NameTypeRequired
    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/listRelatedPlaces

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    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 ListReviewsResult

    interface 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/listReviews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.google_maps.listReviews({ query: "Space Needle, Seattle, WA" });
  • listSavedPlacesThe places the signed-in caller saved.

    Arguments

    None.

    Returns ListSavedPlacesResult

    interface 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/listSavedPlaces

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.google_maps.listSavedPlaces();
  • resolvePlaceUrlA Google Maps link somebody pasted.

    Arguments

    NameTypeRequired
    urlstringYes

    Returns GoogleMapsPlace

    interface GoogleMapsPlace {
      featureId: string;
      name?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/google_maps/resolvePlaceUrl

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    latnumberYes
    lngnumberYes

    Returns ReverseGeocodeResult

    interface 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/reverseGeocode

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    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/searchNearby

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    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/searchPlaces

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.google_maps.searchPlaces({ query: "coffee shops in seattle wa" });
  • suggestPlacesGoogle Maps' own autocomplete for a half-typed query.

    Arguments

    NameTypeRequired
    querystringYes

    Returns string[]

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/google_maps/suggestPlaces

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.google_maps.suggestPlaces({ query: "analog coffee seattle" });
Act 4
  • addMissingPlaceAdd a business Google Maps does not list yet.

    Arguments

    NameTypeRequired
    namestringYes
    addressstringYes
    categorystringNo
    phonestringNo
    websitestringNo

    Returns AddMissingPlaceResult

    interface AddMissingPlaceResult {
      submitted: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/google_maps/addMissingPlace

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.google_maps.addMissingPlace({ name: "<name>", address: "<address>" });
  • savePlaceSave a place to one of the signed-in person's own lists.

    Arguments

    NameTypeRequired
    featureIdstringYes

    Returns SavePlaceResult

    interface SavePlaceResult {
      saved: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/google_maps/savePlace

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.google_maps.savePlace({ featureId: "<featureId>" });
  • suggestPlaceEditSend Google a correction about a place.

    Arguments

    NameTypeRequired
    featureIdstringYes
    kind"wrong_info" | "closed" | "other"Yes
    detailsstringYes

    Returns SuggestPlaceEditResult

    interface SuggestPlaceEditResult {
      submitted: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/google_maps/suggestPlaceEdit

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    placeIdstringYes
    ratingnumberYes
    textstringNo

    Returns WriteReviewResult

    interface WriteReviewResult {
      posted: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/google_maps/writeReview

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.google_maps.writeReview({ placeId: "<placeId>", rating: 1 });

Use it from code