calcom-cli

CLI for the Cal.com API v2. Manage schedules, bookings, event types, and availability from the command line.

Made with api2cli.dev.

Features

• Schedules: Create and manage availability schedules
• Bookings: List, view, cancel, reschedule, and confirm bookings
• Event Types: Configure meeting types with custom durations and settings
• Slots: Query available time slots for booking
• User Profile: View your Cal.com profile

Install

Quick start (local build)

bun --version || curl -fsSL https://bun.sh/install | bash
npx api2cli bundle calcom
npx api2cli link calcom

From api2cli.dev (when published)

npx api2cli install calcom-cli

Authentication

Get your Cal.com API key from https://app.cal.com/settings/developer/api-keys

calcom-cli auth set "cal_live_your_api_key_here"
calcom-cli auth test

The CLI automatically includes the required cal-api-version: 2024-08-13 header on all requests.

Usage Examples

# List all schedules
calcom-cli schedules list --json

# Get upcoming bookings
calcom-cli bookings list --status upcoming --json

# Create a new event type
calcom-cli event-types create \
  --title "30min Meeting" \
  --slug "30min" \
  --length-in-minutes 30 \
  --json

# Check available slots
calcom-cli slots list \
  --start-time "2024-01-15T00:00:00Z" \
  --end-time "2024-01-16T00:00:00Z" \
  --event-type-id 123 \
  --json

# Cancel a booking
calcom-cli bookings cancel abc123 \
  --cancellation-reason "Schedule conflict" \
  --json

# Reschedule a booking
calcom-cli bookings reschedule abc123 \
  --start "2024-01-16T14:00:00Z" \
  --reschedule-reason "Better time" \
  --json

Resources

• schedules - Manage availability schedules
• bookings - Manage meeting bookings (list, cancel, reschedule, confirm)
• event-types - Configure meeting types
• slots - Query available time slots
• me - View user profile

Run calcom-cli <resource> --help for resource-specific commands.

Global Flags

All commands support:

• --json - Output as JSON (recommended for automation)
• --format <text|json|csv|yaml> - Output format
• --verbose - Enable debug logging
• --no-color - Disable colored output
• --no-header - Omit table/csv headers

API Documentation

• Base URL: https://api.cal.com/v2
• Docs: https://cal.com/docs/llms.txt
• API Version: 2024-08-13 (automatically included)