Cal.com MCP

официальный

Подключайте AI-клиенты к планировщику Cal.com через протокол Model Context Protocol, используя размещённый сервер на mcp.cal.com или локальный экземпляр.

Смотреть на cal.comПопробовать этот MCPСпонсировано

Что можно делать с Cal Com MCP?

  • Проверка бронирований — Запросите предстоящие или прошлые бронирования с помощью get_bookings, используя фильтры по дате или статусу.
  • Управление типами событий — Создавайте, обновляйте или удаляйте типы событий через create_event_type, update_event_type и delete_event_type.
  • Поиск доступных слотов — Получайте свободные временные слоты с помощью get_availability или проверяйте занятые периоды через get_busy_times.
  • Перенос или отмена встреч — Изменяйте существующие бронирования с помощью reschedule_booking или cancel_booking.
  • Просмотр и редактирование расписаний — Просматривайте, создавайте или обновляйте расписания доступности с помощью get_schedules и связанных инструментов.
  • Управление участниками бронирования — Просматривайте участников с помощью get_booking_attendees или добавляйте кого-либо через add_booking_attendee.

Документация

MCP-сервер

Подключайте AI-клиентов к планированию Cal.com через Model Context Protocol, используя размещённый сервер на mcp.cal.com или локальный экземпляр.

Cal.com MCP-сервер оборачивает Cal.com API v2 в Model Context Protocol, позволяя вам управлять бронированиями, типами событий, расписаниями и многим другим с помощью естественного языка в любом MCP-совместимом клиенте.

Размещённый сервер (mcp.cal.com)

Самый быстрый способ начать — подключить ваш MCP-клиент напрямую к mcp.cal.com. Размещённый сервер использует транспорт Streamable HTTP с аутентификацией OAuth 2.1 — ваш клиент автоматически выполняет процесс авторизации.

Подключение клиента

Укажите вашему MCP-клиенту URL размещённого сервера:

https://mcp.cal.com/mcp

При первом подключении клиент проведёт вас через процесс авторизации OAuth, в ходе которого вы предоставите серверу доступ к вашей учётной записи Cal.com. API-ключ не требуется.

Добавьте следующее в ваш `claude_desktop_config.json`: 
* **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
* **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

```json theme={null}
{
  "mcpServers": {
    "calcom": {
      "url": "https://mcp.cal.com/mcp"
    }
  }
}
```
Откройте **Настройки → MCP** и добавьте новый сервер с URL `https://mcp.cal.com/mcp` или добавьте его в ваш `.cursor/mcp.json`: 
```json theme={null}
{
  "mcpServers": {
    "calcom": {
      "url": "https://mcp.cal.com/mcp"
    }
  }
}
```
Добавьте сервер в настройки MCP VS Code: 
```json theme={null}
{
  "mcpServers": {
    "calcom": {
      "url": "https://mcp.cal.com/mcp"
    }
  }
}
```

Собственный сервер (stdio)

Если вы предпочитаете запускать сервер локально, вы можете использовать транспорт stdio с API-ключом. Это полезно для разработки или когда вам нужен полный контроль над сервером.

Предварительные требования

Подключение клиента

Добавьте следующее в конфигурацию вашего MCP-клиента:

{
  "mcpServers": {
    "calcom": {
      "command": "npx",
      "args": ["@calcom/cal-mcp@latest"],
      "env": {
        "CAL_API_KEY": "cal_live_xxxx"
      }
    }
  }
}

Замените cal_live_xxxx на ваш фактический API-ключ.

Никогда не передавайте и не сохраняйте в системе контроля версий ваш API-ключ. Если он был раскрыт, немедленно смените его в [настройках Cal.com](https://app.cal.com/settings/developer/api-keys).

Доступные инструменты

MCP-сервер предоставляет 34 инструмента, сгруппированных по категориям:

Профиль пользователя

ИнструментОписание
get_meПолучить профиль аутентифицированного пользователя
update_meОбновить профиль пользователя

Типы событий

ИнструментОписание
get_event_typesСписок всех типов событий
get_event_typeПолучить конкретный тип события по ID
create_event_typeСоздать новый тип события
update_event_typeОбновить тип события
delete_event_typeУдалить тип события

Бронирования

ИнструментОписание
get_bookingsСписок бронирований с возможностью фильтрации
get_bookingПолучить конкретное бронирование по UID
create_bookingСоздать новое бронирование
reschedule_bookingПеренести бронирование
cancel_bookingОтменить бронирование
confirm_bookingПодтвердить ожидающее бронирование
mark_booking_absentОтметить отсутствие по бронированию
get_booking_attendeesПолучить всех участников бронирования
add_booking_attendeeДобавить участника в бронирование
get_booking_attendeeПолучить конкретного участника

Расписания

ИнструментОписание
get_schedulesСписок всех расписаний
get_scheduleПолучить конкретное расписание по ID
create_scheduleСоздать новое расписание
update_scheduleОбновить расписание
delete_scheduleУдалить расписание
get_default_scheduleПолучить расписание по умолчанию

Доступность

ИнструментОписание
get_availabilityПолучить доступные временные слоты
get_busy_timesПолучить занятое время из календарей

Конференции

ИнструментОписание
get_conferencing_appsСписок приложений для конференций

Формы маршрутизации

ИнструментОписание
calculate_routing_form_slotsРассчитать слоты на основе ответа формы маршрутизации

Организации

ИнструментОписание
get_org_membershipsПолучить все членства в организациях
create_org_membershipСоздать членство в организации
get_org_membershipПолучить членство в организации
delete_org_membershipУдалить членство в организации
get_org_routing_formsПолучить формы маршрутизации организации
get_org_routing_form_responsesПолучить ответы формы маршрутизации

Примеры запросов

После подключения вы можете взаимодействовать с Cal.com, используя естественный язык:

  • "Какие у меня бронирования на этой неделе?"
  • "Создай 30-минутный тип события 'Быстрый созвон'"
  • "Отмени мою встречу с Джоном завтра"
  • "Покажи мои свободные слоты на следующий понедельник"
  • "Перенеси мою встречу в 14:00 на четверг в 15:00"
  • "Какие у меня есть типы событий?"

Связанные ресурсы