Cal.com Integration

Pro v1.0.0

Automate scheduling with Cal.com API - manage bookings, event types, and availability

Requires Claude Code CLI

This skill integrates with Cal.com through Claude Code. Install Claude Code and add this skill to use it.

Available Actions

List Bookings

Retrieve all bookings in your Cal.com account

Returns

object JSON object containing array of bookings with details

Try saying...

  • "Show me all my Cal.com bookings"
  • "List my scheduled meetings"
  • "What bookings do I have?"

Create Booking

Schedule a new booking for an event type

Parameters

Name Type Required Description
event-type-id integer Required ID of the event type to book
start string Required Start time in ISO 8601 format
name string Required Attendee's full name
email string Required Attendee's email address
timezone string Optional Timezone for the booking
notes string Optional Additional notes for the booking

Returns

object Created booking details including confirmation

Try saying...

  • "Create a Cal.com booking for tomorrow at 2pm"
  • "Schedule a meeting with John Doe next Tuesday"
  • "Book a 30-minute call for Friday morning"

List Event Types

Retrieve all configured event types in your account

Returns

object JSON object containing array of event types with IDs, titles, and durations

Try saying...

  • "What event types do I have in Cal.com?"
  • "Show my Cal.com meeting templates"
  • "List available meeting types"

Get Availability

Check available time slots for an event type within a date range

Parameters

Name Type Required Description
event-type-id integer Required ID of the event type
start string Required Start date in YYYY-MM-DD format
end string Required End date in YYYY-MM-DD format
timezone string Optional Timezone for availability check

Returns

object Available time slots within the specified range

Try saying...

  • "When am I available for meetings next week?"
  • "Show open slots for my 30-minute meeting"
  • "Check availability between Jan 15-20"

Cancel Booking

Cancel an existing booking by its ID

Parameters

Name Type Required Description
booking-id integer Required ID of the booking to cancel
reason string Optional Reason for cancellation

Returns

object Cancellation confirmation

Try saying...

  • "Cancel my Cal.com booking #12345"
  • "Remove the meeting scheduled for tomorrow"
  • "Delete booking with ID 789"

Reschedule Booking

Move a booking to a new time

Parameters

Name Type Required Description
booking-id integer Required ID of the booking to reschedule
new-start string Required New start time in ISO 8601 format
reason string Optional Reason for rescheduling

Returns

object Updated booking details

Try saying...

  • "Reschedule my 2pm meeting to 3pm"
  • "Move booking #12345 to next Tuesday"
  • "Change the meeting time to tomorrow at 10am"

Getting Started

API Key Easy Setup
  1. 1 Log in to Cal.com at https://app.cal.com
  2. 2 Navigate to Settings > Security
  3. 3 Scroll to API Keys section
  4. 4 Click 'Create New API Key'
  5. 5 Copy the generated key (starts with cal_live_)
  6. 6 Add to shell config: echo 'export CAL_COM_API_KEY="YOUR_KEY"' >> ~/.zshrc
  7. 7 Restart terminal or run: source ~/.zshrc

Verify Setup

python scripts/client.py list-event-types

Success: Returns JSON with your event types

View full setup guide

Security & Access

Access Scope

Full access to your Cal.com account including all bookings, event types, schedules, and attendee data

  • API key grants complete access to your Cal.com account - keep it secure
  • Never commit API keys to version control or share them publicly
  • Rotate API keys periodically for security
  • Revoke unused API keys immediately from Settings > Security
  • Monitor API usage in your Cal.com dashboard
  • Each API key should be used for a single application/purpose

Limitations

  • API key authentication only (OAuth available for platform integrations)
  • Some advanced features require platform-level access
  • Webhook management requires separate configuration

Get This Skill

Requires Pro subscription ($9/month)

Quick Reference

Type
REST API
Auth
API Key
Setup
Easy Setup
Tools Required
Bash
Python Dependencies
requests

Documentation

Have Feedback?

Help us improve this skill by sharing your ideas and suggestions.

Request Improvements