Calcom Api

This is a comprehensive wrapper for Cal.com's v2 API that handles scheduling infrastructure. Use it when you need to programmatically create bookings, check availability slots, or manage event types in Cal.com. The skill includes detailed references for all major endpoints (bookings, schedules, webhooks, calendars) and walks through the standard workflow: query available slots, create a booking, store the UID for later operations. Authentication uses bearer tokens, with optional OAuth support for platform integrations managing multiple users. The reference docs are thorough, which matters since scheduling APIs can get messy around timezone handling and availability logic. A solid choice if you're building anything that needs to integrate with Cal.com's scheduling engine.

skills.sh installs: 189
GitHub stars: 45K
last updated: Jun 3, 2026

View on GitHub

Install

$ npx -y skills add calcom/cal.com --skill calcom-api --agent claude-code

Installs into .claude/skills of the current project.

Files

Cal.diy API v2

This skill provides guidance for AI agents to interact with the Cal.diy API v2, enabling scheduling automation, booking management, and calendar integrations.

Base URL

All API requests should be made to:

https://api.cal.com/v2

Required Credentials

Environment Variable	Required	Description
`CAL_API_KEY`	Yes	Cal.diy API key (prefixed with `cal_live_` or `cal_test_`). Used as Bearer token for all API requests. Generate from Settings > Developer > API Keys.
`CAL_CLIENT_ID`	No	OAuth client ID for platform integrations that manage users on behalf of others. Sent as `x-cal-client-id` header.
`CAL_SECRET_KEY`	No	OAuth client secret for platform integrations. Sent as `x-cal-secret-key` header.
`CAL_WEBHOOK_SECRET`	No	Secret for verifying webhook payload signatures via the `X-Cal-Signature-256` header.

Authentication

All API requests require authentication via Bearer token:

Authorization: Bearer cal_<your_api_key>

For detailed authentication methods including OAuth/Platform authentication, see references/authentication.md.

Core Concepts

SKILL.md on GitHub

Details

Repository: github.com/calcom/cal.com
Category: Backend & APIs
First seen: Jun 3, 2026

More from calcom/cal.com

All 3