Connect Cal.com to Claude Code

Find open slots, and book, reschedule or cancel meetings on Cal.com, cloud or self-hosted. Add Toolspoke to Claude Code once and it can use 16 Cal.com actions. Your Cal.com credential stays in Toolspoke, and you choose which actions Claude Code may call.

Set it up in Claude Code

Three steps, the first one once for every toolkit you will ever add.

  1. Add Toolspoke to Claude Code

    Run it in your project, then /mcp to sign in

    claude mcp add --transport http toolspoke https://toolspoke.com/mcp

    The sign-in opens in your browser, and Toolspoke asks you to approve it.

  2. Install Cal.com and connect it

    Add Cal.com to a project in your Toolspoke workspace.

    API key. You provide it once, when you install the connector. Toolspoke encrypts it at rest and decrypts it only for the length of a single call, and the gateway attaches it to the outbound request itself, so it is never part of the arguments an agent sends.

    API key
    Cal.com → Settings → Developer → API Keys → Add. The key acts as the user who created it.
  3. Choose what Claude Code may do

    All 16 actions start on. Switch off any of the 6 actions that change something in Cal.com, and Claude Code gets a refusal if it tries.

What you can ask Claude Code for

A few of the Cal.com actions that only read, so they are safe to try first.

  • List event types, the bookable meeting kinds with their slug, length and locations
  • Read one event type in full, length, locations, booking fields, limits and the schedule it books against
  • List open slots for an event type between two times
  • List bookings with their attendees, times, status and location

What Claude Code can do in Cal.com

10 actions read, one writes and 5 delete or permanently change something.

Reads

  • Get me

    Read the profile of the user the API key belongs to, username, email, time zone, week start and default schedule.

  • List event types

    List event types, the bookable meeting kinds with their slug, length and locations. With no arguments, the key owner's own; with username, someone else's public ones.

  • Get event type

    Read one event type in full, length, locations, booking fields, limits and the schedule it books against.

  • Get available slots

    List open slots for an event type between two times. Identify the event type by eventTypeId, or by eventTypeSlug plus username. Times are UTC ISO 8601; timeZone sets the zone the slots come back in.

  • List bookings

    List bookings with their attendees, times, status and location. Filter by status, attendee, event type or time window.

  • Get booking

    Read one booking, attendees, times, status, location, the answers the attendee gave and any cancellation reason.

  • List schedules

    List the key owner's availability schedules, working hours per weekday, date overrides and time zone.

  • Get default schedule

    Read the key owner's default availability schedule.

  • List calendars

    List the calendars connected to Cal.com, with the credentialId and externalId get_busy_times needs.

  • Get busy times

    Read the busy blocks on one connected calendar between two dates. Times only, no event titles.

Writes

  • Mark booking absent

    Record a no-show on a past booking, the host, some attendees, or both. Nobody is notified and it can be set back.

Deletes or permanently changes

  • Create booking

    Book a meeting for an attendee. Destructive rather than write: Cal.com emails the attendee a confirmation and puts the meeting in their calendar the moment it succeeds. Check get_available_slots first; start must be one of the open slots.

  • Reschedule booking

    Move a booking to a new start time. Destructive because Cal.com emails every attendee the change at once.

  • Cancel booking

    Cancel a booking. Attendees are emailed at once and the slot is released; there is no undo.

  • Confirm booking

    Accept a booking that is waiting for confirmation. Destructive because the attendee is emailed the confirmation at once.

  • Decline booking

    Decline a booking that is waiting for confirmation. The attendee is emailed at once.

Cal.com in Claude Code: questions

Does Claude Code see my Cal.com credential?

No. The credential is stored encrypted in Toolspoke, and the gateway adds it to each call. Claude Code only ever talks to Toolspoke, and the dashboard shows the last four characters of the credential and nothing more.

Can I stop Claude Code from changing things in Cal.com?

Yes. Each of the 16 actions can be switched off for a project. Turn off the 6 that change something and Claude Code can only read.

Will 16 actions crowd Claude Code's context?

No. Toolspoke shows Claude Code five bridge tools, plus a guide where a toolkit has one, and Claude Code searches for the Cal.com action it needs when it needs it. Adding more toolkits does not add more tools to its list.

Can I add it once for every project?

Yes. Add --scope user to the command and Claude Code keeps Toolspoke in every project on this machine. Without it, the server is added to the project you ran the command in.

What does it cost?

Tool calls are free on every plan, and a Cal.com call does not run in a sandbox, so it bills nothing.

Try Cal.com in Claude Code

Free to start, and tool calls cost nothing on any plan.