К основному содержанию
скилл CX Codex

calcom-api — скилл для Claude Code: что делает и как установить

Скилл calcom-api настраивает работу агента с Cal.diy API v2 для бронирования встреч, проверки свободных слотов и управления расписанием календарей.

MIT 1 установок ★ 50 297 обновлён 2026-10-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add calcom/cal.diy --skill calcom-api -a claude-code
Открыть на GitHub

Что делает calcom-api

Скилл даёт ассистенту инструкции и справочники для интеграции с API Cal.diy v2 через адрес https://api.cal.com/v2. Внутри заложены правила работы с базовыми сущностями: типами событий (Event Types), бронированиями (Bookings), графиками доступности (Schedules) и свободными интервалами (Slots). Агент учится проверять окна для записи перед отправкой запроса и обрабатывать переносы встреч по их UID.

Для вызовов обязателен ключ CAL_API_KEY с префиксом cal_live_ или cal_test_, передаваемый в заголовке как Bearer-токен. Без этого ключа запросы к API отклоняются. При платформенной интеграции от имени сторонних пользователей понадобятся CAL_CLIENT_ID и CAL_SECRET_KEY, а для проверки подписей вебхуков через заголовок X-Cal-Signature-256 служит переменная CAL_WEBHOOK_SECRET.

Какие задачи решает

  • проверить доступные слоты времени перед созданием записи
  • создать бронирование встречи через запрос к /v2/bookings
  • отменить или перенести бронь по её идентификатору UID
  • настроить получение уведомлений через вебхуки Cal.diy

Примеры запросов агенту

  • Проверь свободные слоты для типа встречи 123 на следующей неделе
  • Создай бронь на 15 января в 10:00 для [email protected] с часовым поясом America/New_York
  • Перенеси бронирование с UID book_123 на новое доступное время

Как установить calcom-api

1Через Skills CLI (Vercel)

npx skills add calcom/cal.diy --skill calcom-api -a claude-code

2Вручную: положить файлы

~/.claude/skills/calcom-api/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/calcom-api/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о calcom-api

Как установить calcom-api в Claude Code?

Выполните команду npx skills add calcom/cal.diy --skill calcom-api -a claude-code. Файл навыка сохранится по пути ~/.claude/skills/calcom-api/SKILL.md.

Что делает скилл calcom-api?

Он снабжает агента инструкциями по работе с эндпоинтами Cal.diy API v2, помогая проверять расписание, оформлять бронирования встреч и отслеживать вебхуки.

Какие переменные окружения нужны для работы?

Обязательно требуется CAL_API_KEY с префиксом cal_live_ или cal_test_. Для OAuth-интеграций и верификации вебхуков можно задать CAL_CLIENT_ID, CAL_SECRET_KEY и CAL_WEBHOOK_SECRET.

Исходный текст

SKILL.md · MIT
---
name: calcom-api
description: Interact with the Cal.diy API v2 to manage scheduling, bookings, event types, availability, and calendars. Use this skill when building integrations that need to create or manage bookings, check availability, configure event types, or sync calendars with Cal.diy's scheduling infrastructure.
env:
  CAL_API_KEY:
    description: "Cal.diy API key (prefixed with cal_live_ or cal_test_). Required for all API requests."
    required: true
  CAL_CLIENT_ID:
    description: "OAuth client ID for platform integrations managing users on behalf of others. Sent as x-cal-client-id header."
    required: false
  CAL_SECRET_KEY:
    description: "OAuth client secret for platform integrations. Sent as x-cal-secret-key header."
    required: false
  CAL_WEBHOOK_SECRET:
    description: "Secret used to verify webhook payload signatures via X-Cal-Signature-256 header."
    required: false
---

# 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

**Event Types** define bookable meeting configurations (duration, location, availability rules). Each event type has a unique slug used in booking URLs.

**Bookings** are confirmed appointments created when someone books an event type. Each booking has a unique UID for identification.

**Schedules** define when a user is available for bookings. Users can have multiple schedules with different working hours.

**Slots** represent available time windows that can be booked based on event type configuration and user availability.

## Reference Documentation

This skill includes detailed API reference documentation for each domain:

| Reference | Description |
|-----------|-------------|
| `references/authentication.md` | API key and OAuth authentication, rate limiting, security best practices |
| `references/bookings.md` | Create, list, cancel, reschedule bookings |
| `references/event-types.md` | Configure bookable meeting types |
| `references/schedules.md` | Manage user availability schedules |
| `references/slots-availability.md` | Query available time slots |
| `references/calendars.md` | Calendar connections and busy times |
| `references/webhooks.md` | Real-time event notifications |

## Quick Start

### 1. Check Available Slots

Before creating a booking, check available time slots:

```http
GET /v2/slots?startTime=2024-01-15T00:00:00Z&endTime=2024-01-22T00:00:00Z&eventTypeId=123
```

See `references/slots-availability.md` for full details.

### 2. Create a Booking

```http
POST /v2/bookings
Content-Type: application/json

{
  "start": "2024-01-15T10:00:00Z",
  "eventTypeId": 123,
  "attendee": {
    "name": "John Doe",
    "email": "[email protected]",
    "timeZone": "America/New_York"
  }
}
```

See `references/bookings.md` for all booking operations.

### 3. Set Up Webhooks

Receive real-time notifications for booking events:

```http
POST /v2/webhooks
Content-Type: application/json

{
  "subscriberUrl": "https://your-app.com/webhook",
  "triggers": ["BOOKING_CREATED", "BOOKING_CANCELLED"]
}
```

See `references/webhooks.md` for available triggers and payload formats.

## Common Workflows

**Book a meeting**: Check slots -> Create booking -> Store booking UID

**Reschedule**: Get new slots -> POST /v2/bookings/{uid}/reschedule

**Cancel**: POST /v2/bookings/{uid}/cancel with optional reason

## Best Practices

1. Always check slot availability before creating bookings
2. Store booking UIDs for future operations (cancel, reschedule)
3. Use ISO 8601 format for all timestamps
4. Implement webhook handlers for real-time updates
5. Handle rate limiting with exponential backoff

## Additional Resources

- [Full API Reference](https://cal.com/docs/api-reference/v2)
- [OpenAPI Specification](https://api.cal.com/v2/docs)

© calcom · MIT · calcom/cal.diy

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
calcom-access terrylica Скилл calcom-access для Claude Code и пяти других платформ даёт агенту доступ к Cal.com API для работы с бронированиями, типами событий, расписаниями и доступностью слотов. Ключ API берётся из 1Password через CALCOM_OP_UUID. CX Codex +1 107установок booking-config terrylica Скилл booking-config для Claude Code настраивает типы встреч, расписания доступности и вебхуки Cal.com через интерфейс агента. Редактирует страницы бронирования без веб-панели. CX Codex +1 103установок Meeting Intelligence API stockvibes07 MCP-сервер Meeting Intelligence API для автоматического поиска времени встреч с учётом часовых поясов, выходных и рабочего времени. Создаёт события в Google Calendar и генерирует ссылки для добавления в календарь. CX Codex +1 10 853установок calendly membrane Подключает Calendly через Membrane и открывает доступ к данным пользователей, событий, встреч, ссылок и вебхуков. Работает с задачами расписания. CX Codex +1 394установок loops-api loops-so Скилл loops-api для Claude Code и других ассистентов помогает интегрировать email-платформу Loops в бэкенд, вебхуки и сервисы автоматизации. Включается при запросах к API и официальным SDK Loops. CX Codex +1 1 700установок whatsapp-cloud-api Bello Sánchez Скилл подкладывает агенту справку по WhatsApp Cloud API: отправка сообщений, вебхуки, шаблоны, окно 24 часов и коды ошибок. CX Codex +1 711установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой