calcom-api_skill

Overview

This skill lets an AI agent interact with the Cal.com API v2 to manage scheduling, bookings, event types, availability, and calendar integrations. It centralizes common scheduling actions—checking slots, creating/cancelling/rescheduling bookings, and managing event types and schedules—using authenticated requests to https://api.cal.com/v2. Use it to automate booking workflows, sync calendars, and handle team or organization scheduling modes. Built around REST endpoints, it supports webhooks and pagination for scalable integrations.

How this skill works

The skill sends authenticated HTTP requests with a Bearer token (keys prefixed with cal_) to the Cal.com v2 endpoints. It inspects availability by querying /v2/slots, manages bookings via /v2/bookings, and handles event types, schedules, calendars, teams, and webhooks through their respective endpoints. Responses return structured JSON; the skill interprets status codes, pagination (take/skip), and common error payloads for retry and error handling. For real-time updates it configures and processes webhook triggers like BOOKING_CREATED and BOOKING_CANCELLED.

When to use it

• Automatically create or manage bookings from a web or mobile app
• Check and display available time slots to end users before booking
• Sync user calendars and block busy times in scheduling flows
• Implement team scheduling modes (COLLECTIVE or ROUND_ROBIN)
• Receive real-time booking events via webhooks for notifications or automation

Best practices

• Always check available slots before creating a booking to avoid conflicts
• Store booking UIDs and eventType IDs for lookups, cancellations, and reschedules
• Use ISO 8601 timestamps and preserve time zones when creating or showing bookings
• Implement webhook handlers for real-time updates instead of polling
• Respect rate limits and implement exponential backoff on 429 responses
• Cache event type and schedule data to reduce repeated API calls

Example use cases

• Booking widget: show available slots for a selected event type and create bookings
• Admin dashboard: list, filter, cancel, or reschedule bookings for users
• Team scheduling: create team event types and distribute bookings with round-robin
• Calendar sync: list connected calendars and query busy times to prevent double-booking
• Workflow automation: trigger follow-ups when BOOKING_CONFIRMED or MEETING_STARTED webhooks arrive