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.
Add Toolspoke to Claude Code
Run it in your project, then /mcp to sign in
claude mcp add --transport http toolspoke https://toolspoke.com/mcpThe sign-in opens in your browser, and Toolspoke asks you to approve it.
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.
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.
Cal.com in your other apps
Try Cal.com in Claude Code
Free to start, and tool calls cost nothing on any plan.