Cal.com MCP

официальный

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

Смотреть на cal.com

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

Check your upcoming bookings — Ask for a list of your bookings with filters like date range or status using get_bookings.
Create and manage event types — Create, update, or delete event types such as a "Quick Chat" via create_event_type and related tools.
Reschedule or cancel meetings — Reschedule a booking to a new time with reschedule_booking or cancel it entirely with cancel_booking.
Find available time slots — Retrieve open slots for a given date range using get_availability before scheduling.
Manage your schedules — View, create, or modify your availability schedules with get_schedules and create_schedule.
Handle booking attendees — View all attendees for a booking with get_booking_attendees or add new ones with add_booking_attendee.

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

MCP-сервер

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

MCP-сервер Cal.com оборачивает 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-ключом. Это полезно для разработки или когда вам нужен полный контроль над сервером.

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

Node.js >= 18
API-ключ Cal.com — создайте его в разделе Настройки → Разработчик → 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"
"Какие у меня есть типы событий?"

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

Руководство по AI-агентам — создание AI-агентов с использованием API Cal.com напрямую
Справочник API v2 — полная документация по конечным точкам API
Репозиторий GitHub — исходный код