Skill

cal-com

Every Cal.com feature, plus offline agendas, composed booking flows, and analytics no other Cal.com tool ships.

Verified: 2026-05-13 (printing-press-ingest-2026-05-13+enrich-capability-skill)

When to use cal-com

Choose if

You're building a scheduling agent on top of Cal.com and need full feature parity (bookings, slots, agendas, analytics, webhooks, out-of-office, team workload) plus capabilities the Cal.com UI doesn't expose: offline calendar search, double-booking detection, composed reschedule-to-next-slot flows. The CLI also has --dry-run so the agent can preview write operations before committing.

Avoid if

You're on Calendly, Acuity, SavvyCal, Google Calendar booking pages, or any non-Cal.com scheduler — this is Cal.com-only. Also avoid if your token can't carry the write scopes (EVENT_TYPE_WRITE, SCHEDULE_WRITE) and your job requires mutation; read-only tokens hit the same CLI but get permission errors on the write paths.

Risk Flags

  • MEDIUM data_quality README notes the CLI "surfaces double-bookings the API silently allows" — handy when auditing, but agents creating bookings must not assume the API will reject conflicts.
  • MEDIUM scope Managed event types: parent event-type IDs cannot fetch slots directly — must use child event-type IDs. Seated bookings with "show attendees" disabled require owner/admin auth to list attendees.
  • MEDIUM auth Requires CAL_COM_TOKEN with specific scopes (BOOKING_READ, EVENT_TYPE_WRITE, PROFILE_READ, SCHEDULE_WRITE, WEBHOOK_READ). Insufficient scope yields silent gaps in agent results.
  • LOW scope Slot reservations expire after 5 minutes — agents holding slots while waiting on user confirmation must refresh or rebook.
  • LOW data_quality Misconfigured timezone in a schedule silently returns no slots — no error, just empty results. Agents should validate schedule timezone before reporting "no availability."

Cost

Type: Usage based · Free tier: Cal.com offers a free plan with API access; the CLI binary is MIT-licensed.

Hidden costs

  • The CLI is free, but Cal.com itself has free + paid plans. Some features referenced (AI agent interactions, certain analytics) use Cal.com's internal credits system.

Install

Default

npx -y @mvanhorn/printing-press install cal-com
export CAL_COM_TOKEN=<your-token>
# Token must include scopes: BOOKING_READ, EVENT_TYPE_WRITE,
# PROFILE_READ, SCHEDULE_WRITE, WEBHOOK_READ (or subset for
# read-only use cases).

Setup docs →

Estimated time to first success: ~10 min

Dependencies

Minimum runtime: Node.js 18+ (or Go 1.26.3+ for source install); active Cal.com account + API token

Distribution

Repository
https://github.com/mvanhorn/printing-press-library
License
MIT