Cal.com MCP server for AI agents
Let Claude, ChatGPT or your own agent read Cal.com: 4 typed functions through one MCP server. No Cal.com API key needed.
- Site
- cal.com
- Functions
- 4
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Cal.com 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/cal_comOne MCP server for Cal.com 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
Open a function to see its arguments, what it returns and how to call it.
findProfilesFinds a person's own Cal.com page from their full name and, optionally, their company.Arguments
Name Type Required namestringYes companystringNo Returns
CalComFindProfilesResultinterface CalComProfileCandidate { slug: string; url: string; // where the page landed; a one-event profile redirects to that event title: string; // the page's own <title> ownerName: string | null; // read off the title nameMatches: boolean; // ownerName carries BOTH names asked for, a hint, a namesake passes too description: string | null; // the page's own meta description ("… With Peer Richelsen, Co-Founder of Cal.com"); null when none } interface CalComFindProfilesResult { name: string; company: string | null; slugsChecked: string[]; candidates: CalComProfileCandidate[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/cal_com/findProfilesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.cal_com.findProfiles("Karan Vaidya");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.cal_com.findProfiles("Karan Vaidya"))curl -X POST https://api.bowmark.ai/v1/sites/cal_com/findProfiles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"name":"Karan Vaidya"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.cal_com.findProfiles("Karan Vaidya");getAvailabilityReturns the real, currently-open time slots for one Cal.com event type.Arguments
Name Type Required usernamestringYes opts.daysAheadnumberNo Returns
CalComAvailabilityResultinterface CalComEventType { slug: string; title: string; id: number; lengthInMinutes: number | null; description: string | null; url: string; } interface CalComSlot { start: string; } interface CalComDay { date: string; slots: CalComSlot[]; } interface CalComAvailabilityResult { username: string; eventType: CalComEventType; days: CalComDay[]; otherEventTypes: CalComEventType[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/cal_com/getAvailabilityCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.cal_com.getAvailability("<username>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.cal_com.getAvailability("<username>"))curl -X POST https://api.bowmark.ai/v1/sites/cal_com/getAvailability \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"username":"<username>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.cal_com.getAvailability("<username>");getBookingFormReads what a Cal.com booking page will ask before anyone books.Arguments
Name Type Required urlstringYes opts.eventstringWhich event on a multi-event profile.No Returns
CalComBookingForminterface CalComEventType { slug: string; title: string; id: number; lengthInMinutes: number | null; description: string | null; url: string; } interface CalComFormQuestion { label: string; // what a booker reads name: string; // Cal.com's own field name ("name", "email", or a custom slug) type: string; // Cal.com's own type: "name" | "email" | "phone" | "text" | "textarea" | "select" | "radio" | … required: boolean; choices: string[]; } interface CalComBookingEvent { title: string; slug: string; url: string; description: string | null; lengthInMinutes: number | null; } interface CalComBookingForm { url: string; username: string; eventTypes: CalComEventType[]; // a profile's list; empty when the url already named an event event: CalComBookingEvent | null; // null when several events exist and none was named ownerName: string | null; organization: string | null; // the org/team Cal.com itself files the account under avatarUrl: string | null; questions: CalComFormQuestion[]; // only what a booker is shown, hidden and reschedule-only fields dropped warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/cal_com/getBookingFormCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.cal_com.getBookingForm("<url>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.cal_com.getBookingForm("<url>"))curl -X POST https://api.bowmark.ai/v1/sites/cal_com/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.cal_com.getBookingForm("<url>");getEventTypesLists every event type a Cal.com username currently publishes.Arguments
Name Type Required usernamestringYes Returns
CalComEventTypesResultinterface CalComEventType { slug: string; title: string; id: number; lengthInMinutes: number | null; description: string | null; url: string; } interface CalComEventTypesResult { username: string; eventTypes: CalComEventType[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/cal_com/getEventTypesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.cal_com.getEventTypes("<username>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.cal_com.getEventTypes("<username>"))curl -X POST https://api.bowmark.ai/v1/sites/cal_com/getEventTypes \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"username":"<username>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.cal_com.getEventTypes("<username>");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/cal_com/<function> - OpenAPI
/v1/sites/cal_com/openapi.json