Punctual MCP

Свой планировщик встреч на Cloudflare Workers со встроенным MCP-сервером: агент смотрит слоты, создает и переносит записи

  • 127 ★ репозитория
  • Последний коммит
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Агент с ключом на запись создает, переносит и отменяет встречи, а гости получают письма.
  • Права агента равны правам ключа API: ключ только на чтение ограничивает его просмотром слотов.
Все причины и проверки

cccrafts/punctual

Установка

Ручная установка

npx punctual-sh init

Первая команда быстрого старта из README: клонирует репозиторий, создает ресурсы Cloudflare и выкатывает Worker.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Агент с ключом на запись создает, переносит и отменяет встречи, а гости получают письма.
  • Права агента равны правам ключа API: ключ только на чтение ограничивает его просмотром слотов.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Punctual — открытая альтернатива Calendly, которая целиком работает на Cloudflare Workers и разворачивается одной командой в собственный аккаунт Cloudflare. Страницы записи, синхронизация с Google Calendar и Microsoft 365, команды с распределением по очереди, письма с приглашениями .ics, REST API и вебхуки входят в состав. Встроенный MCP-сервер отвечает на `/mcp` по Streamable HTTP. Агенту доступны пять инструментов: `list_event_types`, `get_available_slots`, `create_booking`, `reschedule_booking` и `cancel_booking`. Права агента равны правам API-ключа, которым он авторизован: два уровня, чтение и запись. Время слота агент берет точно из списка свободных, произвольное время сервер отклоняет.

Для кого. Небольшим командам, которые ведут запись на встречи на своей инфраструктуре и хотят дать агенту доступ к календарю.

Подходит, если

  • Клиент просит агента найти свободное окно и записать его на консультацию.
  • Встречу надо перенести или отменить через агента, и письма гостям должны уйти сами.
  • Нужна замена Calendly без лимитов на число сотрудников, на своем аккаунте Cloudflare.
  • Календарь Google или Microsoft 365 должен видеть записи вместе с названиями компаний гостей.

Не подходит, если

  • Нет аккаунта Cloudflare или нужен готовый хостинг: управляемая версия продается отдельно.
  • Агенту нельзя доверить запись и отмену встреч: для него есть ключ с правом только на чтение.
  • Нужна стабильная версия: проект на стадии v0.1, интерфейсы еще меняются.

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

Покажи свободные слоты на этой неделе для типа встречи «Консультация 30 минут» и запиши Анну на ближайший.

MCP

Транспорт
http
Авторизация
API-ключ

Ограничения

Сервис запускается только в вашем аккаунте Cloudflare: D1, KV, R2, Queues и секреты нужно создать, `npx punctual-sh init` делает это сам. Проект на версии v0.1, интерфейсы до 1.0 могут измениться. Для синхронизации календарей Google и Microsoft 365 нужно приложение OAuth, которое вы регистрируете сами. MCP-сервер работает без сессий и без потока SSE: на GET и DELETE он отвечает 405. Последний коммит в репозитории датирован октябрем 2026 года.

Как отключить. Удалите ключ API, который вы выдали агенту, и уберите адрес `/mcp` из настроек клиента. Сам сервис снимается удалением Worker и ресурсов D1, KV и R2 в Cloudflare.

Частые вопросы

Как поставить Punctual?

Нужны Node 20 или новее и аккаунт Cloudflare. Команда `npx punctual-sh init` клонирует репозиторий, создает ресурсы D1, KV, R2 и Queues, генерирует секреты, запускает миграции и деплой.

Какие инструменты MCP есть у агента?

Пять: `list_event_types`, `get_available_slots`, `create_booking`, `reschedule_booking` и `cancel_booking`. Первые два читают, остальные меняют данные и требуют право записи.

Что ограничивает действия агента?

Права ключа API. MCP использует ту же проверку, что и REST API, поэтому агент не сделает с календарем того, чего не может владелец ключа.

Можно ли записать на произвольное время?

Нет. Параметр `start` берут из списка свободных слотов, который вернул `get_available_slots`. Другое время сервер отклонит, даже если оно выглядит свободным.

Есть ли ограничения на число сотрудников?

Нет. Авторы закрепили в лицензии MIT, что открытая версия для одной команды не получит лимитов на места и платных функций планирования.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы
Официальный

Самохостинг-планировщик встреч с встроенным MCP-сервером: агент смотрит слоты, бронирует, переносит и отменяет записи на звонки.

MCP-серверШирокий доступ134Звезды репозитория

MCP календарь для Claude Desktop: агент смотрит, создает, переносит и удаляет события Google Calendar, включая повторяющиеся, по запросу на обычном языке

MCP-серверШирокий доступ59Звезды репозитория
Официальный

Заметки на Cloudflare Workers без своего сервера с MCP-конечной точкой и скиллом, через которые агент ищет и пишет ваши записи

MCP-серверШирокий доступ346Звезды репозитория

MCP сервер для календаря macOS: агент создает, находит и меняет события естественным языком

MCP-серверРасширенный доступ333Звезды репозитория
Российский стек

MCP-сервер Планфикса: задачи, проекты, контакты, комментарии и сотрудники через REST API

MCP-серверШирокий доступ5Звезды репозитория
Официальный

Официальный плагин и MCP-сервер Astravue: 87 инструментов для задач, проектов, учета времени и 8 готовых скиллов планирования.

ПлагинШирокий доступ12Звезды репозитория

Коротко о README

В README описаны разворачивание в Cloudflare одной командой, возможности планировщика, принципы защиты от двойной записи и работа со временем в UTC. Про MCP сказано одной строкой, детали есть в коде сервера по пути `src/http/mcp`.

Бейдж для README

Сообщить о проблеме

Foxx AIPunctual
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.