Reserve with Google MCP server for AI agents

Let Claude, ChatGPT or your own agent read and act on Reserve with Google: 15 typed functions through one MCP server. No Reserve with Google API key needed.

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

Connect

Just Reserve with Google

An MCP server for Reserve with Google 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/reserve_with_google
Every site

One MCP server for Reserve with Google 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 9
  • checkAvailabilityFor a Google-hosted merchant and party size, returns every bookable day plus the time slots (open or taken) for the nearest bookable day, or for a…

    Arguments

    NameTypeRequired
    merchantIdstring
    Google-hosted merchant id from findBookablePlaces/getBookingOptions, e.g. "ACNsCyuOaeQ".
    Yes
    partySizenumber
    Party size; defaults to 2.
    No
    datestringNo
    timestring
    Venue-local time the slots are centred on, "HH:MM" 24-hour, used with date; defaults to "19:00".
    No

    Returns Availability

    interface AvailabilitySlot {
      /** Venue-local label, e.g. "9:30 PM". */
      time: string;
      /** Slot start, ISO UTC. */
      startsAt: string;
      available: boolean;
    }
    
    interface Availability {
      merchantId: string;
      partySize: number;
      /** Every day with an opening for this party size, "YYYY-MM-DD", venue-local. */
      bookableDates: string[];
      /** The venue-local day asked for, echoed back; absent when none was asked. */
      date?: string;
      /** The venue-local time the slots are centred on, with date. */
      time?: string;
      /** Time slots: for the nearest bookable day, or the hour either side of date and time when given. */
      slots: AvailabilitySlot[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reserve_with_google/checkAvailability

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reserve_with_google.checkAvailability({ merchantId: "ACNsCyuOaeQ", partySize: 2 });
  • findBookablePlacesFinds places you can book through Reserve with Google from words.

    Arguments

    NameTypeRequired
    querystringYes

    Returns BookablePlace[]

    interface BookingAction {
      kind: "google-hosted" | "partner";
      /** Set when kind is "google-hosted": the Maps-hosted booking page's merchant id, e.g. "ACNsCyuOaeQ", pass to getMerchant. */
      merchantId?: string;
      /** Set when kind is "google-hosted": which Reserve with Google vertical, e.g. "dine". */
      vertical?: string;
      /** Set when kind is "partner": the site that fulfills the booking, e.g. "Tock", "Square". */
      partner?: string;
      /** The button's own label, e.g. "Reserve a table", "Book online". */
      label: string;
      /** The link Google's own page shows for this action. */
      url: string;
    }
    
    interface BookablePlace {
      featureId: string;
      name: string;
      url: string;
      address: string;
      coordinates: { lat: number; lng: number } | null;
      categories: string[];
      booking: BookingAction;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reserve_with_google/findBookablePlaces

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reserve_with_google.findBookablePlaces("restaurants in seattle");
  • getBookingFinds one of the caller's bookings on their Bookings page by the venue's feature id.

    Arguments

    NameTypeRequired
    featureIdstringYes

    Returns BookingVenue

    interface BookingVenue {
      /** The venue's name as Google shows it on the caller's Bookings page. */
      name: string;
      address: string;
      phone: string | null;
      /** IANA time zone, e.g. "America/Los_Angeles". */
      timeZone: string;
      featureId: string | null;
      googleMapsUrl: string | null;
      /** The site fulfilling the booking, e.g. "Tock". */
      partner: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reserve_with_google/getBooking

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reserve_with_google.getBooking("dummy-feature-id");
  • getBookingOptionsLists the booking action one place offers on Google.

    Arguments

    NameTypeRequired
    placestringYes

    Returns BookingAction[]

    interface BookingAction {
      kind: "google-hosted" | "partner";
      /** Set when kind is "google-hosted": the Maps-hosted booking page's merchant id, e.g. "ACNsCyuOaeQ", pass to getMerchant. */
      merchantId?: string;
      /** Set when kind is "google-hosted": which Reserve with Google vertical, e.g. "dine". */
      vertical?: string;
      /** Set when kind is "partner": the site that fulfills the booking, e.g. "Tock", "Square". */
      partner?: string;
      /** The button's own label, e.g. "Reserve a table", "Book online". */
      label: string;
      /** The link Google's own page shows for this action. */
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reserve_with_google/getBookingOptions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reserve_with_google.getBookingOptions("Elliott's Oyster House Seattle");
  • getMerchantReads one Google-hosted booking page by merchant id or its www.google.com/maps/reserve/v/… URL: the venue's details, the partner fulfilling the…

    Arguments

    NameTypeRequired
    merchantIdstringYes

    Returns Merchant

    interface Merchant {
      merchantId: string;
      name: string;
      photos: string[];
      rating: number | null;
      coordinates: { lat: number; lng: number } | null;
      address: string;
      phone: string | null;
      website: string | null;
      googleMapsUrl: string | null;
      partner: string | null;
      timeZone: string;
      category: string | null;
      featureId: string | null;
      partySizes: number[];
      serviceWindowSeconds: [number, number] | null;
      room: string | null;
      bookableDays: number[];
      deposit: { text: string; amountUsd: number | null; perPerson: boolean } | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reserve_with_google/getMerchant

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reserve_with_google.getMerchant("ACNsCyuOaeQ");
  • getSettingsReads the caller's Reserve with Google Settings page and returns the page's own data blocks (ds:N), raw.

    Arguments

    None.

    Returns ReserveSettings

    interface ReserveSettings {
      /** The Settings page's AF_initDataCallback blocks, keyed "ds:0", "ds:1"…, raw.
       * Field positions are undecoded: the signed-in page has never been captured. */
      dataBlocks: Record<string, unknown>;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reserve_with_google/getSettings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reserve_with_google.getSettings();
  • listMyBookingsLists the venues of the caller's Reserve with Google bookings off their own Bookings page.

    Arguments

    None.

    Returns BookingVenue[]

    interface BookingVenue {
      /** The venue's name as Google shows it on the caller's Bookings page. */
      name: string;
      address: string;
      phone: string | null;
      /** IANA time zone, e.g. "America/Los_Angeles". */
      timeZone: string;
      featureId: string | null;
      googleMapsUrl: string | null;
      /** The site fulfilling the booking, e.g. "Tock". */
      partner: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reserve_with_google/listMyBookings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reserve_with_google.listMyBookings();
  • listMyPacksLists the venues the caller holds class packs or memberships at, off their own Reserve with Google Packs page.

    Arguments

    None.

    Returns BookingVenue[]

    interface BookingVenue {
      /** The venue's name as Google shows it on the caller's Bookings page. */
      name: string;
      address: string;
      phone: string | null;
      /** IANA time zone, e.g. "America/Los_Angeles". */
      timeZone: string;
      featureId: string | null;
      googleMapsUrl: string | null;
      /** The site fulfilling the booking, e.g. "Tock". */
      partner: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reserve_with_google/listMyPacks

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reserve_with_google.listMyPacks();
  • listPartnersLists every booking provider connected to Reserve with Google (Booksy, OpenTable, Tock…) with its site and logo, from Google's own partner directory…

    Arguments

    None.

    Returns Partner[]

    interface Partner {
      /** The booking provider's name as Google lists it, e.g. "Booksy". */
      name: string;
      /** The partner's own site, as linked from Google's directory. */
      url: string;
      /** Logo image URL, when Google shows one. */
      logo: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reserve_with_google/listPartners

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reserve_with_google.listPartners();
Act 6
  • bookReservationBooks a slot from checkAvailability on the caller's own Google account, with party size and an optional note, and returns the confirmation.

    Arguments

    NameTypeRequired
    merchantIdstring
    Google-hosted merchant id, e.g. "ACNsCyuOaeQ".
    Yes
    startsAtstring
    A slot's startsAt from checkAvailability, ISO UTC.
    Yes
    partySizenumber
    Party size; defaults to 2.
    No
    notestring
    Optional note to the venue, filled when the form has a note field.
    No

    Returns BookReservationResult

    interface BookReservationResult {
      merchantId: string;
      startsAt: string;
      partySize: number;
    
      confirmed: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reserve_with_google/bookReservation

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reserve_with_google.bookReservation({ merchantId: "<merchantId>", startsAt: "<startsAt>" });
  • cancelBookingCancels the caller's booking at one venue, found by the venue feature id listMyBookings returns, and reports it cancelled.

    Arguments

    NameTypeRequired
    featureIdstringYes

    Returns CancelBookingResult

    interface CancelBookingResult {
      featureId: string;
      /** The venue name the cancelled booking was at. */
      venue: string;
      cancelled: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reserve_with_google/cancelBooking

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reserve_with_google.cancelBooking("<featureId>");
  • joinWaitlistAdds the caller to a Google-hosted restaurant's waitlist with a party size, where the venue offers "Join waitlist" on its Google booking page, and…

    Arguments

    NameTypeRequired
    merchantIdstring
    Google-hosted merchant id, e.g. "ACNsCyuOaeQ".
    Yes
    partySizenumber
    Party size; defaults to 2.
    No

    Returns JoinWaitlistResult

    interface JoinWaitlistResult {
      merchantId: string;
      partySize: number;
    
      joined: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reserve_with_google/joinWaitlist

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reserve_with_google.joinWaitlist({ merchantId: "<merchantId>" });
  • leaveWaitlistTakes the caller off a venue's waitlist that joinWaitlist put them on, found by the venue feature id listMyBookings returns, and reports it left.

    Arguments

    NameTypeRequired
    featureIdstringYes

    Returns LeaveWaitlistResult

    interface LeaveWaitlistResult {
      featureId: string;
      /** The venue whose waitlist the caller left. */
      venue: string;
      left: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reserve_with_google/leaveWaitlist

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reserve_with_google.leaveWaitlist("<featureId>");
  • modifyBookingChanges the time or party size of the caller's booking at one venue, found by the venue feature id listMyBookings returns, where the partner allows…

    Arguments

    NameTypeRequired
    featureIdstring
    The booking's venue feature id, as listMyBookings returns it.
    Yes
    startsAtstring
    New slot start, ISO UTC, a slot checkAvailability shows for the venue.
    No
    partySizenumber
    New party size.
    No

    Returns ModifyBookingResult

    interface ModifyBookingResult {
      featureId: string;
      venue: string;
      startsAt?: string;
      partySize?: number;
      modified: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reserve_with_google/modifyBooking

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reserve_with_google.modifyBooking({ featureId: "<featureId>" });
  • updateSettingsChanges the contact name, phone or email on the caller's Reserve with Google Settings page by filling the page's own labelled fields and pressing…

    Arguments

    NameTypeRequired
    namestring
    Contact name Google passes to the merchant with a booking.
    No
    phonestring
    Contact phone, e.g. "+12065550100".
    No
    emailstring
    Contact email.
    No

    Returns UpdateSettingsResult

    interface UpdateSettingsResult {
      /** The fields this call filled and saved, e.g. ["phone"]. */
      updated: Array<"name" | "phone" | "email">;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/reserve_with_google/updateSettings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.reserve_with_google.updateSettings({});

Use it from code