calcom-cli

When To Use This Skill

Use the calcom-cli skill when you need to:

• Manage Cal.com schedules (create, update, delete availability)
• View, cancel, reschedule, or confirm bookings
• Create and manage event types
• Check available time slots for scheduling
• View user profile information

Capabilities

• Schedules: List, create, update, delete availability schedules with timezone support
• Bookings: List, view, cancel, reschedule, and confirm bookings with filters (status, date range, attendee)
• Event Types: Create and manage event types with custom durations, buffers, and booking fields
• Slots: Query available time slots for booking
• Profile: View current user profile details

Common Use Cases

• "List all my upcoming bookings"
• "Cancel booking xyz with reason 'Schedule conflict'"
• "Create a new 30-minute meeting event type"
• "Show available slots for tomorrow between 9am and 5pm"
• "Update my work hours schedule to use Pacific timezone"
• "Reschedule booking abc to next Tuesday at 2pm"

Setup

If calcom-cli is not installed, install it from GitHub:

npx api2cli install Melvynx/calcom-cli

If calcom-cli is not found, install and build it:

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

api2cli link adds ~/.local/bin to PATH automatically. The CLI is available in the next command.

Always use --json flag when calling commands programmatically.

Working Rules

• Always use --json for agent-driven calls so downstream steps can parse the result.
• Start with --help if the exact action or flags are unclear instead of guessing.
• Prefer read commands first when you need to inspect current state before mutating data.

Authentication

calcom-cli auth set "your-token"
calcom-cli auth test

Auth commands: auth set , auth show, auth remove, auth test

Token is stored in ~/.config/tokens/calcom-cli.txt.

Resources

schedules

Manage availability schedules.

• list - List all schedules
• get - Get a specific schedule
• create --name --time-zone - Create new schedule
• update [--name] [--time-zone] - Update schedule
• delete - Delete schedule

bookings

Manage meeting bookings.

• list [--status] [--after-start] [--before-end] [--attendee-email] - List bookings with filters
• get - Get booking details
• cancel [--cancellation-reason] - Cancel a booking
• reschedule --start [--reschedule-reason] - Reschedule booking
• confirm - Confirm a pending booking

event-types

Manage event type configurations.

• list [--event-slug] - List all event types
• get - Get event type details
• create --title