Cal.com в MCP: бронирования, свободные слоты и расшифровки звонков в любом AI-агенте

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Cal.com, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Cal.com

Читайте аккаунт планирования Cal.com из Claude, ChatGPT или Copilot: типы событий, бронирования с участниками, записи и расшифровки Cal Video, свободные слоты, расписания доступности и подключённые календари. Создание, перенос и отмена бронирований есть, но при установке отключены.

Настройка

Настройка занимает около 2 минут. Нужен аккаунт Cal.com (любой тариф), чтобы создать личный API-ключ. Ключ действует от имени пользователя, который его создал.

1. Войдите в Cal.com и откройте Settings → Developer → API Keys (на app.cal.com или на app.cal.eu, если ваш аккаунт находится в европейском регионе Cal.com).
2. Нажмите New, задайте ключу имя (например, AnythingMCP) и срок действия и скопируйте его. Ключ начинается с cal_live_ (или cal_test_ в тестовом режиме) и показывается только один раз.
3. Вставьте только сам ключ, без слова Bearer, в CALCOM_API_KEY.
4. Укажите в CALCOM_API_HOST значение https://api.cal.com, если вы входите через app.cal.com, или https://api.cal.eu, если через app.cal.eu. Без /v2, пути и косой черты в конце: /v2 коннектор добавляет сам. Ключ работает только в своём регионе.
5. Установите коннектор и запустите calcom_get_me: он покажет пользователя, которому принадлежит ключ, с часовым поясом и расписанием по умолчанию, и подтвердит, что ключ и хост подходят друг к другу.

Чьи данные видны: типы событий, бронирования и расписания владельца ключа, а также командные бронирования, где этот пользователь хост или администратор. Все, кто пользуется коннектором, работают с этим одним аккаунтом, поэтому берите ключ того человека (или администратора команды), чьи встречи должен видеть ИИ.

Что он читает: ваши типы событий (шаблоны встреч, которые можно забронировать) с длительностью, местами проведения, полями формы бронирования, буферами, минимальным сроком до встречи и ссылкой на бронирование; бронирования со статусом, временем, ссылкой на встречу, хостами, участниками с email и часовым поясом, гостями и ответами на вопросы формы; записи и расшифровки Cal Video по бронированию; свободные слоты типа события; ваши расписания доступности с рабочими часами по дням недели и исключениями по датам; и подключённые календари (Google, Outlook, Apple, CalDAV), включая те, что проверяются на пересечения, и тот, в который записываются новые бронирования.

uid бронирования, а не id: инструменты бронирований принимают uid, строку, которую ИИ берёт из calcom_list_bookings, а не числовой id. uid повторяющегося бронирования возвращает все его повторы. Бронирования фильтруются по статусу (upcoming, past, cancelled, unconfirmed), участнику, типу события, команде или датам и приходят постранично.

Часовые пояса: свободные слоты возвращаются в том часовом поясе, в котором вы мыслите и который ИИ передаёт в calcom_get_available_slots, а время начала бронирования уходит в Cal.com в UTC. В слотах уже учтены ваши календари, буферы, минимальный срок до встречи и лимиты.

Записи и расшифровки: они есть только у встреч в Cal Video, и читать их могут только организатор, администратор команды или администратор организации. У встреч в Zoom, Google Meet или Teams их здесь нет. Расшифровка появляется, если кто-то нажал Transcribe во время звонка, а ссылка на её скачивание действует один час, поэтому при необходимости ИИ запрашивает новую.

Отключено при установке: calcom_create_booking, calcom_reschedule_booking и calcom_cancel_booking. Они отправляют письма реальным участникам и меняют реальные календари: новое бронирование рассылает подтверждения и приглашения (платные типы событий могут попросить участника оплатить), перенос отменяет старое бронирование и создаёт новое с новым uid, а отмену нельзя откатить (у повторяющегося бронирования отменяются все повторы). Администратор может включать их по одному.

Спрашивает перед каждым изменением: когда инструмент записи включён, ИИ сначала проверяет время через calcom_get_available_slots, затем показывает тип события, время в вашем часовом поясе, участника и гостей или причину и ждёт вашего согласия.

Ограничения: Cal.com допускает около 120 запросов в минуту на один API-ключ. После ответа 429 ИИ ждёт минуту и пробует снова.

Частые ошибки: 401 Invalid API Key означает, что ключ неверный, истёк, удалён или относится к другому региону. 403 означает, что ключ работает, но этот пользователь не видит это бронирование, тип события или команду: используйте ключ организатора или администратора команды. 404 обычно значит, что вместо uid бронирования передан числовой id. При 400 Cal.com называет поле, которое не принял, чаще всего это время начала, не совпадающее со свободным слотом.

Коннектор не меняет типы событий, расписания доступности и подключённые календари, не принимает и не возвращает платежи.

Предварительные требования: CALCOM_API_HOST, CALCOM_API_KEY

Локальная установка коннектора

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Откройте http://localhost:3000/connectors/store, выберите Cal.com и введите переменные, перечисленные в Предварительных требованиях.

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

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

• «Какие встречи у меня завтра и кто участвует в каждой?»
• «Найди на следующей неделе три свободных слота для моего типа события Знакомство по московскому времени, чтобы предложить их клиенту.»
• «Возьми расшифровку вчерашнего звонка с ООО Вектор и выпиши задачи, о которых мы договорились.»
• «Какие бронирования в этом месяце отменили или перенесли и какие причины указали?»
• «Какие у меня рабочие часы в расписании по умолчанию и какие календари Cal.com проверяет на пересечения?»

Следующие шаги

• Подключить к Claude
• Подключить к ChatGPT