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.

Functions
4
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just Cal.com

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_com
Every site

One 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/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

Open a function to see its arguments, what it returns and how to call it.

Read 4
  • findProfilesFinds a person's own Cal.com page from their full name and, optionally, their company.

    Arguments

    NameTypeRequired
    namestringYes
    companystringNo

    Returns CalComFindProfilesResult

    interface 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/findProfiles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.cal_com.findProfiles("Karan Vaidya");
  • getAvailabilityReturns the real, currently-open time slots for one Cal.com event type.

    Arguments

    NameTypeRequired
    usernamestringYes
    opts.daysAheadnumberNo

    Returns CalComAvailabilityResult

    interface 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/getAvailability

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.cal_com.getAvailability("<username>");
  • getBookingFormReads what a Cal.com booking page will ask before anyone books.

    Arguments

    NameTypeRequired
    urlstringYes
    opts.eventstring
    Which event on a multi-event profile.
    No

    Returns CalComBookingForm

    interface 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/getBookingForm

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.cal_com.getBookingForm("<url>");
  • getEventTypesLists every event type a Cal.com username currently publishes.

    Arguments

    NameTypeRequired
    usernamestringYes

    Returns CalComEventTypesResult

    interface 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/getEventTypes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.cal_com.getEventTypes("<username>");

Use it from code