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.
- Site
- google.com
- Functions
- 15
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
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_googleOne 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/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.
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
Name Type Required merchantIdstringGoogle-hosted merchant id from findBookablePlaces/getBookingOptions, e.g. "ACNsCyuOaeQ".Yes partySizenumberParty size; defaults to 2.No datestringNo timestringVenue-local time the slots are centred on, "HH:MM" 24-hour, used with date; defaults to "19:00".No Returns
Availabilityinterface 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/checkAvailabilityCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.reserve_with_google.checkAvailability({ merchantId: "ACNsCyuOaeQ", partySize: 2 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.reserve_with_google.checkAvailability({"merchantId": "ACNsCyuOaeQ", "partySize": 2}))curl -X POST https://api.bowmark.ai/v1/sites/reserve_with_google/checkAvailability \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"merchantId":"ACNsCyuOaeQ","partySize":2}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.reserve_with_google.checkAvailability({ merchantId: "ACNsCyuOaeQ", partySize: 2 });findBookablePlacesFinds places you can book through Reserve with Google from words.Arguments
Name Type Required 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/findBookablePlacesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.reserve_with_google.findBookablePlaces("restaurants in seattle");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.reserve_with_google.findBookablePlaces("restaurants in seattle"))curl -X POST https://api.bowmark.ai/v1/sites/reserve_with_google/findBookablePlaces \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"restaurants in seattle"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required featureIdstringYes Returns
BookingVenueinterface 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/getBookingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.reserve_with_google.getBooking("dummy-feature-id");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.reserve_with_google.getBooking("dummy-feature-id"))curl -X POST https://api.bowmark.ai/v1/sites/reserve_with_google/getBooking \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"featureId":"dummy-feature-id"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.reserve_with_google.getBooking("dummy-feature-id");getBookingOptionsLists the booking action one place offers on Google.Arguments
Name Type Required 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/getBookingOptionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.reserve_with_google.getBookingOptions("Elliott's Oyster House Seattle");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.reserve_with_google.getBookingOptions("Elliott's Oyster House Seattle"))curl -X POST https://api.bowmark.ai/v1/sites/reserve_with_google/getBookingOptions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"place":"Elliott'\''s Oyster House Seattle"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required merchantIdstringYes Returns
Merchantinterface 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/getMerchantCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.reserve_with_google.getMerchant("ACNsCyuOaeQ");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.reserve_with_google.getMerchant("ACNsCyuOaeQ"))curl -X POST https://api.bowmark.ai/v1/sites/reserve_with_google/getMerchant \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"merchantId":"ACNsCyuOaeQ"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
ReserveSettingsinterface 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/getSettingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.reserve_with_google.getSettings();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.reserve_with_google.getSettings())curl -X POST https://api.bowmark.ai/v1/sites/reserve_with_google/getSettings \ -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.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/listMyBookingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.reserve_with_google.listMyBookings();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.reserve_with_google.listMyBookings())curl -X POST https://api.bowmark.ai/v1/sites/reserve_with_google/listMyBookings \ -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.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/listMyPacksCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.reserve_with_google.listMyPacks();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.reserve_with_google.listMyPacks())curl -X POST https://api.bowmark.ai/v1/sites/reserve_with_google/listMyPacks \ -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.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/listPartnersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.reserve_with_google.listPartners();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.reserve_with_google.listPartners())curl -X POST https://api.bowmark.ai/v1/sites/reserve_with_google/listPartners \ -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.reserve_with_google.listPartners();
bookReservationBooks a slot from checkAvailability on the caller's own Google account, with party size and an optional note, and returns the confirmation.Arguments
Name Type Required merchantIdstringGoogle-hosted merchant id, e.g. "ACNsCyuOaeQ".Yes startsAtstringA slot's startsAt from checkAvailability, ISO UTC.Yes partySizenumberParty size; defaults to 2.No notestringOptional note to the venue, filled when the form has a note field.No Returns
BookReservationResultinterface BookReservationResult { merchantId: string; startsAt: string; partySize: number; confirmed: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/reserve_with_google/bookReservationCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.reserve_with_google.bookReservation({ merchantId: "<merchantId>", startsAt: "<startsAt>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.reserve_with_google.bookReservation({"merchantId": "<merchantId>", "startsAt": "<startsAt>"}))curl -X POST https://api.bowmark.ai/v1/sites/reserve_with_google/bookReservation \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"merchantId":"<merchantId>","startsAt":"<startsAt>"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required featureIdstringYes Returns
CancelBookingResultinterface 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/cancelBookingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.reserve_with_google.cancelBooking("<featureId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.reserve_with_google.cancelBooking("<featureId>"))curl -X POST https://api.bowmark.ai/v1/sites/reserve_with_google/cancelBooking \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"featureId":"<featureId>"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required merchantIdstringGoogle-hosted merchant id, e.g. "ACNsCyuOaeQ".Yes partySizenumberParty size; defaults to 2.No Returns
JoinWaitlistResultinterface JoinWaitlistResult { merchantId: string; partySize: number; joined: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/reserve_with_google/joinWaitlistCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.reserve_with_google.joinWaitlist({ merchantId: "<merchantId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.reserve_with_google.joinWaitlist({"merchantId": "<merchantId>"}))curl -X POST https://api.bowmark.ai/v1/sites/reserve_with_google/joinWaitlist \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"merchantId":"<merchantId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required featureIdstringYes Returns
LeaveWaitlistResultinterface 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/leaveWaitlistCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.reserve_with_google.leaveWaitlist("<featureId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.reserve_with_google.leaveWaitlist("<featureId>"))curl -X POST https://api.bowmark.ai/v1/sites/reserve_with_google/leaveWaitlist \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"featureId":"<featureId>"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required featureIdstringThe booking's venue feature id, as listMyBookings returns it.Yes startsAtstringNew slot start, ISO UTC, a slot checkAvailability shows for the venue.No partySizenumberNew party size.No Returns
ModifyBookingResultinterface ModifyBookingResult { featureId: string; venue: string; startsAt?: string; partySize?: number; modified: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/reserve_with_google/modifyBookingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.reserve_with_google.modifyBooking({ featureId: "<featureId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.reserve_with_google.modifyBooking({"featureId": "<featureId>"}))curl -X POST https://api.bowmark.ai/v1/sites/reserve_with_google/modifyBooking \ -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.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
Name Type Required namestringContact name Google passes to the merchant with a booking.No phonestringContact phone, e.g. "+12065550100".No emailstringContact email.No Returns
UpdateSettingsResultinterface 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/updateSettingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.reserve_with_google.updateSettings({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.reserve_with_google.updateSettings({}))curl -X POST https://api.bowmark.ai/v1/sites/reserve_with_google/updateSettings \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.reserve_with_google.updateSettings({});
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/reserve_with_google/<function> - OpenAPI
/v1/sites/reserve_with_google/openapi.json