Booksy MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on Booksy: 23 typed functions through one MCP server. No Booksy API key needed.
- Site
- booksy.com
- Functions
- 23
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Booksy 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/booksyOne MCP server for Booksy 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.
getAvailabilityReturns the open appointment times for one service at one business over a date range, optionally with a chosen staff member: per day, the bookable…Arguments
Name Type Required businessnumber | stringYes serviceVariantIdnumberA service variant id from getBusiness.Yes startDatestring"YYYY-MM-DD".Yes endDatestring"YYYY-MM-DD", default startDate.No staffIdnumberA staff member id from getBusiness, default any ("autoassign").No countrystringNo Returns
booksyAvailabilityinterface booksyAvailability { business: number; serviceVariantId: number; staffId: number; days: { date: string | null; times: string[] }[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/booksy/getAvailabilityCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booksy.getAvailability({ business: 110442, serviceVariantId: 4546809, startDate: { $daysFromNow: 1 } });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booksy.getAvailability({ "business": 110442, "serviceVariantId": 4546809, "startDate": {"$daysFromNow": 1} }))curl -X POST https://api.bowmark.ai/v1/sites/booksy/getAvailability \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"business":110442,"serviceVariantId":4546809,"startDate":{"$daysFromNow":1}}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.booksy.getAvailability({ business: 110442, serviceVariantId: 4546809, startDate: { $daysFromNow: 1 } });getBookingQuotePrices an appointment before booking it: the service, start and end time, the staff member assigned, the total, any deposit or prepayment the…Arguments
Name Type Required businessnumber | stringYes serviceVariantIdnumberA service variant id from getBusiness.Yes startTimestringA start time from getAvailability's days[].times, "YYYY-MM-DDTHH:MM".Yes staffIdnumberNo countrystringNo Returns
booksyBookingQuoteinterface booksyBookingQuote { business: number; serviceVariantId: number; serviceName: string | null; startTime: string | null; endTime: string | null; currency: string | null; total: number | null; /** What this booking would charge now; $0 for a pay-at-business appointment. */ payableNow: number | null; /** The card hold forfeit on a late cancellation or no-show, if the business takes one. */ cancellationFee: number | null; prepayment: number | null; /** Always null, a dry run creates nothing. */ appointmentUid: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/booksy/getBookingQuoteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booksy.getBookingQuote({ business: 1, serviceVariantId: 1, startTime: "<startTime>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booksy.getBookingQuote({ "business": 1, "serviceVariantId": 1, "startTime": "<startTime>" }))curl -X POST https://api.bowmark.ai/v1/sites/booksy/getBookingQuote \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"business":1,"serviceVariantId":1,"startTime":"<startTime>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.booksy.getBookingQuote({ business: 1, serviceVariantId: 1, startTime: "<startTime>" });getBusinessReturns one business from its id or its booksy.com page URL: name, description, address and coordinates, opening hours and exceptions, staff, the…Arguments
Name Type Required businessnumber | stringA Booksy business id (110442) or its booksy.com page URL.Yes countrystringNo Returns
booksyBusinessinterface booksyServiceSummary { id: number; name: string | null; price: string | null; durationMinutes: number | null; } interface booksyBusinessCard { /** Pass back as `business`. */ id: number; name: string | null; url: string | null; checkout: booksyCheckout | null; primaryCategoryId: number | null; address: string | null; city: string | null; latitude: number | null; longitude: number | null; rating: number | null; reviewsCount: number | null; imageUrl: string | null; promoted: boolean; acceptsBooksyPay: boolean; services: booksyServiceSummary[]; } interface booksyVariant { /** The service variant id getAvailability and getBookingQuote take. */ id: number; label: string | null; durationMinutes: number | null; price: number | null; priceText: string | null; deposit: number | null; prepayment: number | null; staff: { id: number; name: string | null }[]; } interface booksyBusiness extends booksyBusinessCard { description: string | null; website: string | null; instagram: string | null; facebook: string | null; openingHours: { day: string; open: string | null; close: string | null }[]; openingHoursNote: string | null; staff: { id: number; name: string | null; description: string | null; photoUrl: string | null }[]; serviceCategories: { name: string | null; services: { id: number; name: string | null; description: string | null; treatment: string | null; bookableOnline: boolean; variants: booksyVariant[] }[]; }[]; bookingPolicy: string | null; depositPolicy: string | null; waitlistEnabled: boolean; amenities: string[]; parking: string | null; wheelchairAccess: string | null; } interface booksyCheckout { status: "ready_to_checkout" | "needs_login" | "unavailable"; /** Always https, on the studio's own site. */ url: string; /** ready_to_checkout only: carries_items opens this very slot, product_page opens the studio's schedule. */ urlKind?: "carries_items" | "signed_in_cart" | "product_page"; /** unavailable only: out_of_stock (class full, no waitlist) or not_available_for_dates (cancelled). */ reason?: string; detail?: string; account: { site: string; hint: string; signedInAs?: string; signInUrl?: string }; summary: { items: { title: string; variant: string | null; quantity: number; unitPrice: string | null; lineTotal: string | null; url?: string; id?: string }[]; total: string | null; currency: string; /** ISO start/end of the class or slot, with the studio's UTC offset when the site gives one. */ dates?: { start: string; end?: string }; } | null; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/booksy/getBusinessCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booksy.getBusiness({ business: 110442 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booksy.getBusiness({"business": 110442}))curl -X POST https://api.bowmark.ai/v1/sites/booksy/getBusiness \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"business":110442}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.booksy.getBusiness({ business: 110442 });getBusinessContactReturns a business's contact email, which Booksy shows only to a signed-in customer.Arguments
Name Type Required businessnumber | stringA business id, or its booksy.com page URL.Yes countrystringNo Returns
booksyBusinessContactinterface booksyBusinessContact { business: number; /** Null when the business shows no email. */ email: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/booksy/getBusinessContactCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booksy.getBusinessContact({ business: 110442 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booksy.getBusinessContact({"business": 110442}))curl -X POST https://api.bowmark.ai/v1/sites/booksy/getBusinessContact \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"business":110442}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.booksy.getBusinessContact({ business: 110442 });getBusinessNetworkNames the Booksy network a business belongs to (a chain or curated group) and lists its member businesses' ids, so a caller can read each with…Arguments
Name Type Required businessnumber | stringYes countrystringNo Returns
booksyBusinessNetworkinterface booksyBusinessNetwork { business: number; country: string; network: { name: string | null; slug: string; businessIds: number[] } | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/booksy/getBusinessNetworkCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booksy.getBusinessNetwork({ business: 8122, country: "pl" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booksy.getBusinessNetwork({"business": 8122, "country": "pl"}))curl -X POST https://api.bowmark.ai/v1/sites/booksy/getBusinessNetwork \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"business":8122,"country":"pl"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.booksy.getBusinessNetwork({ business: 8122, country: "pl" });getBusinessPhotosLists a business's portfolio and venue photos, and the photos customers attached to reviews.Arguments
Name Type Required businessnumber | stringYes pagenumber1-based, applies to the main gallery only -- review photos are always returned in full.No limitnumber1-50, default 20.No countrystringNo Returns
booksyBusinessPhotosinterface booksyPhoto { id: number; url: string | null; /** The site's own album, e.g. "biz_photo", "portfolio", "message_blast_photo". */ category: string | null; isCoverPhoto: boolean; width: number | null; height: number | null; } interface booksyReviewPhoto { id: number; url: string | null; reviewId: number | null; reviewText: string | null; } interface booksyBusinessPhotos { business: number; page: number; total: number | null; photos: booksyPhoto[]; reviewPhotosTotal: number | null; reviewPhotos: booksyReviewPhoto[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/booksy/getBusinessPhotosCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booksy.getBusinessPhotos({ business: 110442, limit: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booksy.getBusinessPhotos({"business": 110442, "limit": 5}))curl -X POST https://api.bowmark.ai/v1/sites/booksy/getBusinessPhotos \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"business":110442,"limit":5}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.booksy.getBusinessPhotos({ business: 110442, limit: 5 });getBusinessReviewsLists a business's customer reviews, newest first: rating, text, date, the service and staff member reviewed, reply from the business and photos.Arguments
Name Type Required businessnumber | stringYes pagenumber1-based.No limitnumber1-50, default 10.No countrystringNo Returns
booksyBusinessReviewsinterface booksyReview { id: number; rating: number | null; text: string | null; createdAt: string | null; appointmentDate: string | null; verified: boolean; services: { id: number; name: string | null }[]; staff: { id: number; name: string | null }[]; reviewerFirstName: string | null; /** The business's own reply, if any. */ reply: string | null; photos: unknown[]; } interface booksyBusinessReviews { business: number; page: number; total: number | null; averageRating: number | null; reviews: booksyReview[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/booksy/getBusinessReviewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booksy.getBusinessReviews({ business: 110442, limit: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booksy.getBusinessReviews({"business": 110442, "limit": 5}))curl -X POST https://api.bowmark.ai/v1/sites/booksy/getBusinessReviews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"business":110442,"limit":5}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.booksy.getBusinessReviews({ business: 110442, limit: 5 });getMyAppointmentReturns one of the signed-in caller's appointments in full: service, time, staff, price paid or due, cancellation deadline and status.Arguments
Name Type Required appointmentUidstring | numberAn appointmentUid from listMyBookings.Yes countrystringNo Returns
booksyMyAppointmentinterface booksyMyAppointment { /** The id getMyAppointment and cancelAppointment take; null on a dry run. */ appointmentUid: string | null; /** accepted, cancelled, finished, no_show, pending_payment, awaiting_confirmation, rejected, or Booksy's own code. */ status: string | null; statusCode: string | null; startTime: string | null; endTime: string | null; currency: string | null; total: number | null; payableNow: number | null; cancellationFee: number | null; prepayment: number | null; business: { id: number | null; name: string | null; address: string | null } | null; services: { serviceId: number | null; serviceName: string | null; serviceVariantId: number | null; startTime: string | null; endTime: string | null; staffId: number | null; staffName: string | null }[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/booksy/getMyAppointmentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booksy.getMyAppointment({ appointmentUid: 1 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booksy.getMyAppointment({"appointmentUid": 1}))curl -X POST https://api.bowmark.ai/v1/sites/booksy/getMyAppointment \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"appointmentUid":1}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.booksy.getMyAppointment({ appointmentUid: 1 });getMyProfileReturns the signed-in caller's Booksy profile: name, email, phone, photo and notification settings.Arguments
Name Type Required countrystringNo Returns
booksyMyProfileinterface booksyMyProfile { id: number | null; firstName: string | null; lastName: string | null; email: string | null; phone: string | null; birthday: string | null; gender: string | null; address: { line1: string | null; line2: string | null; apartment: string | null; city: string | null; zipcode: string | null }; photo: string | null; language: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/booksy/getMyProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booksy.getMyProfile({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booksy.getMyProfile({}))curl -X POST https://api.bowmark.ai/v1/sites/booksy/getMyProfile \ -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.booksy.getMyProfile({});getSearchSuggestionsTurns what a caller typed ("skin fade", "gel nails", a business name) into Booksy's own search suggestions -- treatments and businesses with the ids…Arguments
Name Type Required textstringWhat a caller is typing, e.g. "skin fade".Yes countrystringNo Returns
booksyGetSearchSuggestionsResultinterface booksySuggestion { type: string | null; label: string | null; /** A treatment or category id (searchBusinesses' treatmentId/categoryId), or a business id. */ id: number | null; slug: string | null; /** Present only on a treatment suggestion. */ treatmentType: string | null; /** Present only on a business suggestion; pass to getBusiness as `business`. */ businessUrl: string | null; } interface booksyGetSearchSuggestionsResult { text: string; suggestions: booksySuggestion[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/booksy/getSearchSuggestionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booksy.getSearchSuggestions({ text: "fade" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booksy.getSearchSuggestions({"text": "fade"}))curl -X POST https://api.bowmark.ai/v1/sites/booksy/getSearchSuggestions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"text":"fade"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.booksy.getSearchSuggestions({ text: "fade" });listCategoriesLists Booksy's top-level business categories (Hair, Barber, Nails, Skin Care...), the ids searchBusinesses' categoryId filters by.Arguments
Name Type Required countrystringNo Returns
booksyListCategoriesResultinterface booksyCategory { /** The id searchBusinesses' categoryId takes. */ id: number; name: string | null; iconUrl: string | null; } interface booksyListCategoriesResult { country: string; categories: booksyCategory[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/booksy/listCategoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booksy.listCategories({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booksy.listCategories({}))curl -X POST https://api.bowmark.ai/v1/sites/booksy/listCategories \ -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.booksy.listCategories({});listFavoritesLists the businesses the signed-in caller has saved as favourites.Arguments
Name Type Required pagenumberNo limitnumber1-50, default 20.No countrystringNo Returns
booksyFavoritesinterface booksyServiceSummary { id: number; name: string | null; price: string | null; durationMinutes: number | null; } interface booksyBusinessCard { /** Pass back as `business`. */ id: number; name: string | null; url: string | null; checkout: booksyCheckout | null; primaryCategoryId: number | null; address: string | null; city: string | null; latitude: number | null; longitude: number | null; rating: number | null; reviewsCount: number | null; imageUrl: string | null; promoted: boolean; acceptsBooksyPay: boolean; services: booksyServiceSummary[]; } interface booksyCheckout { status: "ready_to_checkout" | "needs_login" | "unavailable"; /** Always https, on the studio's own site. */ url: string; /** ready_to_checkout only: carries_items opens this very slot, product_page opens the studio's schedule. */ urlKind?: "carries_items" | "signed_in_cart" | "product_page"; /** unavailable only: out_of_stock (class full, no waitlist) or not_available_for_dates (cancelled). */ reason?: string; detail?: string; account: { site: string; hint: string; signedInAs?: string; signInUrl?: string }; summary: { items: { title: string; variant: string | null; quantity: number; unitPrice: string | null; lineTotal: string | null; url?: string; id?: string }[]; total: string | null; currency: string; /** ISO start/end of the class or slot, with the studio's UTC offset when the site gives one. */ dates?: { start: string; end?: string }; } | null; warnings: string[]; } interface booksyFavorites { page: number; total: number | null; businesses: booksyBusinessCard[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/booksy/listFavoritesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booksy.listFavorites({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booksy.listFavorites({}))curl -X POST https://api.bowmark.ai/v1/sites/booksy/listFavorites \ -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.booksy.listFavorites({});listGiftCardOffersLists the gift cards and vouchers a business sells online: name, value, price, validity and the services each covers.Arguments
Name Type Required businessnumber | stringYes countrystringNo Returns
booksyGiftCardOffersinterface booksyGiftCardOffer { id: number; name: string | null; value: number | null; price: number | null; validUntil: string | null; description: string | null; services: { id: number; name: string | null }[]; } interface booksyGiftCardOffers { business: number; total: number | null; offers: booksyGiftCardOffer[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/booksy/listGiftCardOffersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booksy.listGiftCardOffers({ business: 110442 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booksy.listGiftCardOffers({"business": 110442}))curl -X POST https://api.bowmark.ai/v1/sites/booksy/listGiftCardOffers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"business":110442}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.booksy.listGiftCardOffers({ business: 110442 });listMyBookingsLists the signed-in caller's upcoming and past Booksy appointments: business, service, time, staff, status and the appointment id the other account…Arguments
Name Type Required state"upcoming" | "past""upcoming" or "past"; omit for both.No pagenumberNo limitnumber1-50, default 20.No countrystringNo Returns
booksyMyBookingsinterface booksyMyAppointment { /** The id getMyAppointment and cancelAppointment take; null on a dry run. */ appointmentUid: string | null; /** accepted, cancelled, finished, no_show, pending_payment, awaiting_confirmation, rejected, or Booksy's own code. */ status: string | null; statusCode: string | null; startTime: string | null; endTime: string | null; currency: string | null; total: number | null; payableNow: number | null; cancellationFee: number | null; prepayment: number | null; business: { id: number | null; name: string | null; address: string | null } | null; services: { serviceId: number | null; serviceName: string | null; serviceVariantId: number | null; startTime: string | null; endTime: string | null; staffId: number | null; staffName: string | null }[]; } interface booksyMyBookings { page: number; total: number | null; bookings: booksyMyAppointment[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/booksy/listMyBookingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booksy.listMyBookings({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booksy.listMyBookings({}))curl -X POST https://api.bowmark.ai/v1/sites/booksy/listMyBookings \ -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.booksy.listMyBookings({});listMyGiftCardsLists the gift cards and vouchers the signed-in caller holds, with balance and validity.Arguments
Name Type Required pagenumberNo countrystringNo Returns
booksyMyGiftCardsinterface booksyMyGiftCard { id: number | null; name: string | null; code: string | null; status: string | null; price: number | null; value: number | null; /** What is left to spend. */ balance: number | null; validTill: string | null; business: { id: number | null; name: string | null; address: string | null } | null; services: { serviceVariantId: number | null; name: string | null }[]; } interface booksyMyGiftCards { page: number; total: number | null; hasMore: boolean; giftCards: booksyMyGiftCard[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/booksy/listMyGiftCardsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booksy.listMyGiftCards({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booksy.listMyGiftCards({}))curl -X POST https://api.bowmark.ai/v1/sites/booksy/listMyGiftCards \ -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.booksy.listMyGiftCards({});resolveLocationResolves a place a caller names ("Brooklyn", a street address) into the Booksy region id and coordinates searchBusinesses takes, with street…Arguments
Name Type Required querystringA city, neighbourhood or street address, e.g. "Brooklyn".Yes countrystringBooksy country subdomain, default "us".No Returns
booksyLocationinterface booksyLocation { query: string; country: string; matched: boolean; formattedAddress: string | null; latitude: number | null; longitude: number | null; type: string | null; /** `region.id` is the `locationId` searchBusinesses takes. */ region: { id: number; name: string | null; fullName: string | null; slug: string | null; type: string | null } | null; /** Street and place completions for a partial query. */ suggestions: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/booksy/resolveLocationCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booksy.resolveLocation({ query: "Brooklyn" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booksy.resolveLocation({"query": "Brooklyn"}))curl -X POST https://api.bowmark.ai/v1/sites/booksy/resolveLocation \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"Brooklyn"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.booksy.resolveLocation({ query: "Brooklyn" });searchBusinessesSearches Booksy's marketplace for businesses (barbers, salons, spas, nail, massage, tattoo...) by free text, category or treatment, near a place or…Arguments
Name Type Required querystringFree text: a treatment, a business name.No categoryIdnumberBooksy category id, e.g. 6 = Barber.No treatmentIdnumberNo locationIdnumberRegion id from resolveLocation.No latitudenumberNo longitudenumberNo openNowbooleanNo hasOnlineServicesbooleanNo pagenumber1-based.No limitnumber1-50, default 20.No countrystringNo Returns
booksyBusinessPageinterface booksyServiceSummary { id: number; name: string | null; price: string | null; durationMinutes: number | null; } interface booksyBusinessCard { /** Pass back as `business`. */ id: number; name: string | null; url: string | null; checkout: booksyCheckout | null; primaryCategoryId: number | null; address: string | null; city: string | null; latitude: number | null; longitude: number | null; rating: number | null; reviewsCount: number | null; imageUrl: string | null; promoted: boolean; acceptsBooksyPay: boolean; services: booksyServiceSummary[]; } interface booksyBusinessPage { country: string; page: number; total: number | null; location: { id: number; name: string | null; type: string | null } | null; businesses: booksyBusinessCard[]; } interface booksyCheckout { status: "ready_to_checkout" | "needs_login" | "unavailable"; /** Always https, on the studio's own site. */ url: string; /** ready_to_checkout only: carries_items opens this very slot, product_page opens the studio's schedule. */ urlKind?: "carries_items" | "signed_in_cart" | "product_page"; /** unavailable only: out_of_stock (class full, no waitlist) or not_available_for_dates (cancelled). */ reason?: string; detail?: string; account: { site: string; hint: string; signedInAs?: string; signInUrl?: string }; summary: { items: { title: string; variant: string | null; quantity: number; unitPrice: string | null; lineTotal: string | null; url?: string; id?: string }[]; total: string | null; currency: string; /** ISO start/end of the class or slot, with the studio's UTC offset when the site gives one. */ dates?: { start: string; end?: string }; } | null; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/booksy/searchBusinessesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booksy.searchBusinesses({ categoryId: 6, locationId: 29902, limit: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booksy.searchBusinesses({"categoryId": 6, "locationId": 29902, "limit": 5}))curl -X POST https://api.bowmark.ai/v1/sites/booksy/searchBusinesses \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"categoryId":6,"locationId":29902,"limit":5}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.booksy.searchBusinesses({ categoryId: 6, locationId: 29902, limit: 5 });
addFavoriteSaves a business to the signed-in caller's favourites.Arguments
Name Type Required businessnumber | stringA business id, or its booksy.com page URL.Yes countrystringNo Returns
booksyFavoriteResultinterface booksyFavoriteResult { business: number; /** True after addFavorite, false after removeFavorite. */ favorite: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/booksy/addFavoriteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booksy.addFavorite({ business: 1 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booksy.addFavorite({"business": 1}))curl -X POST https://api.bowmark.ai/v1/sites/booksy/addFavorite \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"business":1}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.booksy.addFavorite({ business: 1 });bookAppointmentBooks an appointment for the signed-in caller: a service variant at a start time, with a chosen staff member or anyone, plus a note to the business.Arguments
Name Type Required businessnumber | stringYes serviceVariantIdnumberA variant id from getBusiness.Yes startTimestring"YYYY-MM-DDTHH:MM", a time from getAvailability.Yes staffIdnumberA staff member id from getBusiness; omit for anyone.No notestringA note to the business.No countrystringNo Returns
booksyBookedAppointmentinterface booksyMyAppointment { /** The id getMyAppointment and cancelAppointment take; null on a dry run. */ appointmentUid: string | null; /** accepted, cancelled, finished, no_show, pending_payment, awaiting_confirmation, rejected, or Booksy's own code. */ status: string | null; statusCode: string | null; startTime: string | null; endTime: string | null; currency: string | null; total: number | null; payableNow: number | null; cancellationFee: number | null; prepayment: number | null; business: { id: number | null; name: string | null; address: string | null } | null; services: { serviceId: number | null; serviceName: string | null; serviceVariantId: number | null; startTime: string | null; endTime: string | null; staffId: number | null; staffName: string | null }[]; } interface booksyBookedAppointment extends booksyMyAppointment { /** True when the appointment exists and nothing is owed up front. */ booked: boolean; /** True when a deposit or prepayment is due, Bowmark never pays it; finish on booksy.com. */ paymentRequired: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/booksy/bookAppointmentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booksy.bookAppointment({ business: 1, serviceVariantId: 1, startTime: "<startTime>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booksy.bookAppointment({ "business": 1, "serviceVariantId": 1, "startTime": "<startTime>" }))curl -X POST https://api.bowmark.ai/v1/sites/booksy/bookAppointment \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"business":1,"serviceVariantId":1,"startTime":"<startTime>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.booksy.bookAppointment({ business: 1, serviceVariantId: 1, startTime: "<startTime>" });cancelAppointmentCancels one of the signed-in caller's appointments, reporting any cancellation fee the business's policy applies.Arguments
Name Type Required appointmentUidstring | numberAn appointmentUid from listMyBookings.Yes countrystringNo Returns
booksyCancelledAppointmentinterface booksyMyAppointment { /** The id getMyAppointment and cancelAppointment take; null on a dry run. */ appointmentUid: string | null; /** accepted, cancelled, finished, no_show, pending_payment, awaiting_confirmation, rejected, or Booksy's own code. */ status: string | null; statusCode: string | null; startTime: string | null; endTime: string | null; currency: string | null; total: number | null; payableNow: number | null; cancellationFee: number | null; prepayment: number | null; business: { id: number | null; name: string | null; address: string | null } | null; services: { serviceId: number | null; serviceName: string | null; serviceVariantId: number | null; startTime: string | null; endTime: string | null; staffId: number | null; staffName: string | null }[]; } interface booksyCancelledAppointment extends booksyMyAppointment { cancelled: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/booksy/cancelAppointmentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booksy.cancelAppointment({ appointmentUid: "<appointmentUid>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booksy.cancelAppointment({"appointmentUid": "<appointmentUid>"}))curl -X POST https://api.bowmark.ai/v1/sites/booksy/cancelAppointment \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"appointmentUid":"<appointmentUid>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.booksy.cancelAppointment({ appointmentUid: "<appointmentUid>" });removeFavoriteRemoves a business from the signed-in caller's favourites.Arguments
Name Type Required businessnumber | stringA business id, or its booksy.com page URL.Yes countrystringNo Returns
booksyFavoriteResultinterface booksyFavoriteResult { business: number; /** True after addFavorite, false after removeFavorite. */ favorite: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/booksy/removeFavoriteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booksy.removeFavorite({ business: 1 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booksy.removeFavorite({"business": 1}))curl -X POST https://api.bowmark.ai/v1/sites/booksy/removeFavorite \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"business":1}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.booksy.removeFavorite({ business: 1 });updateMyProfileUpdates the signed-in caller's Booksy profile: name, birthday, gender or address.Arguments
Name Type Required firstNamestringNo lastNamestringNo birthdaystring"YYYY-MM-DD".No genderstringNo addressLine1stringNo apartmentNumberstringNo citystringNo zipcodestringNo countrystringNo Returns
booksyMyProfileinterface booksyMyProfile { id: number | null; firstName: string | null; lastName: string | null; email: string | null; phone: string | null; birthday: string | null; gender: string | null; address: { line1: string | null; line2: string | null; apartment: string | null; city: string | null; zipcode: string | null }; photo: string | null; language: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/booksy/updateMyProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booksy.updateMyProfile({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booksy.updateMyProfile({}))curl -X POST https://api.bowmark.ai/v1/sites/booksy/updateMyProfile \ -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.booksy.updateMyProfile({});writeReviewPosts the signed-in caller's 1-5 star rating and review of a business, optionally tied to an appointment.Arguments
Name Type Required businessnumber | stringYes ratingnumber1-5 stars.Yes textstringYes titlestringNo appointmentUidstring | numberThe appointment being reviewed, from listMyBookings.No countrystringNo Returns
booksyMyReviewinterface booksyMyReview { reviewId: number | null; rating: number | null; title: string | null; text: string | null; created: string | null; updated: string | null; business: { id: number | null; name: string | null } | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/booksy/writeReviewCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.booksy.writeReview({ business: 1, rating: 1, text: "<text>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.booksy.writeReview({"business": 1, "rating": 1, "text": "<text>"}))curl -X POST https://api.bowmark.ai/v1/sites/booksy/writeReview \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"business":1,"rating":1,"text":"<text>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.booksy.writeReview({ business: 1, rating: 1, text: "<text>" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/booksy/<function> - OpenAPI
/v1/sites/booksy/openapi.json