Calendly MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on Calendly: 11 typed functions through one MCP server. No Calendly API key needed.
- Site
- calendly.com
- Functions
- 11
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Calendly 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/calendlyOne MCP server for Calendly 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.
findProfilesFinds a person's own Calendly page from their full name and, optionally, their company.Arguments
Name Type Required namestringYes companystringNo Returns
CalendlyFindProfilesResultinterface CalendlyProfileCandidate { slug: string; url: string; ownerName: string; // the name the profile itself shows nameMatches: boolean; // ownerName carries BOTH names asked for, a hint, a namesake passes too timezone: string; description: string | null; // the profile's own description, verbatim (often Calendly's stock greeting) eventTypes: Array<{ name: string; description: string | null }> | null; // what the page offers ("Firecrawl-Introduction"); null = could not be read } interface CalendlyFindProfilesResult { name: string; company: string | null; slugsChecked: string[]; candidates: CalendlyProfileCandidate[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/calendly/findProfilesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.calendly.findProfiles("Caleb Peffer", "firecrawl");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.calendly.findProfiles("Caleb Peffer", "firecrawl"))curl -X POST https://api.bowmark.ai/v1/sites/calendly/findProfiles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"name":"Caleb Peffer","company":"firecrawl"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.calendly.findProfiles("Caleb Peffer", "firecrawl");getAvailabilityReturns the real, currently-open time slots for one Calendly event type over the next N days (default 14).Arguments
Name Type Required profilestringYes opts.timezonestringNo opts.daysAheadnumberNo Returns
CalendlyAvailabilityResultinterface CalendlyEventType { slug: string; name: string; uuid: string; url: string; description: string | null; checkout: CalendlyCheckout | null; } interface CalendlyCheckout { 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 CalendlySlot { startTime: string; inviteesRemaining: number; } interface CalendlyDay { date: string; status: string; // the site's own labels, read the values off a result, never guess one from prose slots: CalendlySlot[]; } interface CalendlyAvailabilityResult { profileSlug: string; eventType: CalendlyEventType; timezone: string; days: CalendlyDay[]; otherEventTypes: CalendlyEventType[]; unavailableReason: string | null; // non-null = Calendly says this event cannot be booked at all; days is [] BECAUSE of that, not because nothing is open }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/calendly/getAvailabilityCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.calendly.getAvailability("<profile>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.calendly.getAvailability("<profile>"))curl -X POST https://api.bowmark.ai/v1/sites/calendly/getAvailability \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"profile":"<profile>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.calendly.getAvailability("<profile>");getBookingReads one booking from the link an invitee was sent.Arguments
Name Type Required linkstringYes Returns
CalendlyBookinginterface CalendlyBookingEvent { name: string; slug: string | null; url: string; description: string | null; durationMinutes: number | null; } interface CalendlyBooking { uuid: string; eventType: CalendlyBookingEvent; // the booked event's details invitee: { name: string; email: string; }; startTime: string | null; // ISO datetime of the booked slot durationMinutes: number | null; cancellationReason: string | null; // non-null = the booking has been cancelled and this is why }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/calendly/getBookingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.calendly.getBooking("<link>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.calendly.getBooking("<link>"))curl -X POST https://api.bowmark.ai/v1/sites/calendly/getBooking \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"link":"<link>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.calendly.getBooking("<link>");getBookingFormReads what a Calendly booking page will ask before anyone books.Arguments
Name Type Required urlstringYes opts.eventstringWhich event on a multi-event profile.No Returns
CalendlyBookingForminterface CalendlyEventType { slug: string; name: string; uuid: string; url: string; description: string | null; checkout: CalendlyCheckout | null; } interface CalendlyCheckout { 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 CalendlyFormQuestion { label: string; format: string; // Calendly's own: "string" | "text" | "phone_number" | "select" | "multi_select" | "radios" | "checkboxes" required: boolean; choices: string[]; } interface CalendlyBookingEvent { name: string; slug: string | null; url: string; description: string | null; durationMinutes: number | null; } interface CalendlyBookingForm { url: string; profileSlug: string | null; // null for a calendly.com/d/<hash> share link ownerName: string | null; eventTypes: CalendlyEventType[]; event: CalendlyBookingEvent | null; // null when several events exist and none was named questions: CalendlyFormQuestion[]; // CUSTOM questions; name + email are always asked on top nextAvailability: string | null; // null + unavailableReason null = fully booked, not unread unavailableReason: string | null; // non-null = Calendly says this cannot be booked warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/calendly/getBookingFormCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.calendly.getBookingForm("<url>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.calendly.getBookingForm("<url>"))curl -X POST https://api.bowmark.ai/v1/sites/calendly/getBookingForm \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"url":"<url>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.calendly.getBookingForm("<url>");getEventTypesLists every event type a Calendly profile currently offers.Arguments
Name Type Required profilestringYes Returns
CalendlyEventTypesResultinterface CalendlyEventType { slug: string; name: string; uuid: string; url: string; description: string | null; checkout: CalendlyCheckout | null; } interface CalendlyCheckout { 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 CalendlyProfile { slug: string; name: string; timezone: string; } interface CalendlyEventTypesResult { profile: CalendlyProfile; eventTypes: CalendlyEventType[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/calendly/getEventTypesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.calendly.getEventTypes("<profile>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.calendly.getEventTypes("<profile>"))curl -X POST https://api.bowmark.ai/v1/sites/calendly/getEventTypes \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"profile":"<profile>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.calendly.getEventTypes("<profile>");getRoutingFormReads a Calendly routing form.Arguments
Name Type Required formstringYes Returns
CalendlyRoutingForminterface CalendlyRoutingFormField { id: string | null; label: string; type: string; required: boolean; choices: string[]; } interface CalendlyRoutingForm { uuid: string; name: string; organization: { uuid: string | null; ownerName: string | null; logoUrl: string | null }; fields: CalendlyRoutingFormField[]; // [] when the form routes an external (HubSpot/Marketo) form submitText: string | null; unavailableReason: string | null; // Calendly's own reason the form cannot be used }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/calendly/getRoutingFormCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.calendly.getRoutingForm("40d00706-9862-459b-b467-2b8ea40f5563");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.calendly.getRoutingForm("40d00706-9862-459b-b467-2b8ea40f5563"))curl -X POST https://api.bowmark.ai/v1/sites/calendly/getRoutingForm \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"form":"40d00706-9862-459b-b467-2b8ea40f5563"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.calendly.getRoutingForm("40d00706-9862-459b-b467-2b8ea40f5563");listPackagesLists the prepaid session packages a Calendly profile sells (several meetings bought together, or a one-off payment link).Arguments
Name Type Required profilestringYes Returns
CalendlyPackagesResultinterface CalendlyPackageSession { eventTypeUuid: string; eventTypeName: string | null; // null when the event type is secret count: number | null; unit: string; // "SESSIONS" } interface CalendlyPackage { id: string; name: string; description: string | null; offeringType: string; // "MEETING_PACKAGE" or "PAYMENT_LINK" price: { amount: number | null; currency: string | null }; // major unit: dollars, not cents sessions: CalendlyPackageSession[]; url: string; // where a person would buy it; never bought here } interface CalendlyPackagesResult { profileSlug: string; packages: CalendlyPackage[]; // [] when the profile sells none }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/calendly/listPackagesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.calendly.listPackages("<profile>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.calendly.listPackages("<profile>"))curl -X POST https://api.bowmark.ai/v1/sites/calendly/listPackages \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"profile":"<profile>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.calendly.listPackages("<profile>");
bookMeetingBooks a slot on a Calendly event the way an invitee does on the booking page.Arguments
Name Type Required urlstringEvent url, profile url + event, or /d/ share link.Yes startTimestringA slot's startTime exactly as getAvailability returned it.Yes namestringYes emailstringYes timezonestringNo guestsstring[]No answersRecord<string, string>Custom-question answers keyed by the question name.No eventstringNo Returns
CalendlyBookMeetingResultinterface CalendlyBookMeetingResult { uuid: string; eventName: string; startTime: string | null; invitee: { name: string; email: string }; cancelUrl: string | null; rescheduleUrl: string | null; confirmationUrl: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/calendly/bookMeetingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.calendly.bookMeeting({ url: "<url>", startTime: "<startTime>", name: "<name>", email: "<email>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.calendly.bookMeeting({ "url": "<url>", "startTime": "<startTime>", "name": "<name>", "email": "<email>" }))curl -X POST https://api.bowmark.ai/v1/sites/calendly/bookMeeting \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"url":"<url>","startTime":"<startTime>","name":"<name>","email":"<email>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.calendly.bookMeeting({ url: "<url>", startTime: "<startTime>", name: "<name>", email: "<email>" });cancelBookingCancels a booking the caller made, from the cancel link Calendly emailed them (calendly.com/cancellations/<uuid>) or the invitee uuid bookMeeting…Arguments
Name Type Required linkstringThe cancel / reschedule / confirmation link, or the bare invitee uuid.Yes reasonstringThe reason the host sees.No Returns
CalendlyCancelBookingResultinterface CalendlyCancelBookingResult { uuid: string; cancelled: true; reason: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/calendly/cancelBookingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.calendly.cancelBooking({ link: "<link>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.calendly.cancelBooking({"link": "<link>"}))curl -X POST https://api.bowmark.ai/v1/sites/calendly/cancelBooking \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"link":"<link>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.calendly.cancelBooking({ link: "<link>" });rescheduleBookingMoves a booking the caller made to another open time, from the reschedule link Calendly emailed them (calendly.com/reschedulings/<uuid>) and a new…Arguments
Name Type Required linkstringThe reschedule / cancel / confirmation link, or the bare invitee uuid.Yes urlstringThe event url the booking was made on (host page or /d/ share link).Yes startTimestringThe new slot, exactly as getAvailability returned it.Yes timezonestringNo guestsstring[]No answersRecord<string, string>Custom-question answers keyed by the question name.No eventstringNo Returns
CalendlyBookMeetingResultinterface CalendlyBookMeetingResult { uuid: string; eventName: string; startTime: string | null; invitee: { name: string; email: string }; cancelUrl: string | null; rescheduleUrl: string | null; confirmationUrl: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/calendly/rescheduleBookingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.calendly.rescheduleBooking({ link: "<link>", url: "<url>", startTime: "<startTime>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.calendly.rescheduleBooking({ "link": "<link>", "url": "<url>", "startTime": "<startTime>" }))curl -X POST https://api.bowmark.ai/v1/sites/calendly/rescheduleBooking \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"link":"<link>","url":"<url>","startTime":"<startTime>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.calendly.rescheduleBooking({ link: "<link>", url: "<url>", startTime: "<startTime>" });submitRoutingFormAnswers a Calendly routing form and returns where it sends you.Arguments
Name Type Required formstringThe form uuid, or any url carrying it.Yes answersRecord<string, string>Keyed by the field id or the question label from getRoutingForm; a choice question takes one of its choices.Yes paramsRecord<string, string>Url parameters the landing page was opened with (utm_*, …).No Returns
CalendlySubmitRoutingFormResultinterface CalendlySubmitRoutingFormResult { formUuid: string; resultType: string; // "event_type_id" | "arbitrary_url" | "thank_you_text" url: string | null; // where the form routes you; never followed thankYou: { headline: string; body: string | null } | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/calendly/submitRoutingFormCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.calendly.submitRoutingForm({ form: "<form>", answers: "<answers>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.calendly.submitRoutingForm({"form": "<form>", "answers": "<answers>"}))curl -X POST https://api.bowmark.ai/v1/sites/calendly/submitRoutingForm \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"form":"<form>","answers":"<answers>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.calendly.submitRoutingForm({ form: "<form>", answers: "<answers>" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/calendly/<function> - OpenAPI
/v1/sites/calendly/openapi.json