Apple Calendar MCP

Расширение для Claude Desktop, которое даёт Claude полный доступ к Apple Calendar на macOS через первоклассный фреймворк Apple EventKit. Чтение, поиск, создание, обновление и удаление событий — включая повторяющиеся события (редактирование отдельного вхождения или всех будущих вхождений), напоминания, структурированные местоположения, чтение участников и доступность free/busy.

Упаковано как расширение для рабочего стола MCPB с иконкой Calendar.app и установкой в один клик.

Компаньон для коннекторов Apple Mail, Apple Reminders, Apple Notes и Apple Messages.

Что он делает

Related MCP server: Apple EventKit MCP Server

Как это работает

Связь с Calendar осуществляется через EventKit (EKEventStore, EKEvent, EKCalendar, EKRecurrenceRule, EKAlarm, EKStructuredLocation) через PyObjC — тот же первоклассный фреймворк, который использует сам Calendar.app, читая то же локальное хранилище (включая календари, синхронизированные с iCloud, Google и Exchange).

Это тот же подход, что и в компаньоне-коннекторе Apple Reminders, и он отличается от маршрута AppleScript/JXA: EventKit предоставляет полную модель данных (чтение повторяемости, редактирование отдельных вхождений, ответы участников, структурированные местоположения) и работает значительно быстрее. В отличие от Reminders, выборка событий в EventKit синхронна, поэтому асинхронный мост не нужен; единственная особенность — предикат событий охватывает максимум ~4 года на запрос, поэтому более широкие диапазоны прозрачно разбиваются на части.

Повторяющиеся события

Вхождения повторяющегося события имеют один стабильный event_id; каждое вхождение, возвращаемое list_events, также содержит occurrence_date. Инструменты записи принимают оба параметра:

• occurrence_date определяет, какое вхождение вы выбираете

• span определяет область: this_event (только это вхождение, отсоединяя его) или future_events (это вхождение и все последующие)

Требования

• macOS 14 Sonoma или новее (requestFullAccessToEvents добавлен в 14)

• Python 3.11+

• Claude Desktop с поддержкой расширений

• Разрешение для Календаря — Полный доступ — предоставленное Claude Desktop (см. ниже)

Установка

Вариант 1: Расширение для рабочего стола (рекомендуется)

Скачайте последний .mcpb из Releases, затем дважды щёлкните для установки.

Или соберите из исходников:

git clone https://github.com/falconbradley/claude-connector-apple-calendar.git
cd claude-connector-apple-calendar
./build.sh

Затем дважды щёлкните dist/apple-calendar.mcpb (или перетащите его в Claude Desktop).

Расширение появится в Настройки > Расширения с иконкой Calendar.

Вариант 2: Ручная настройка MCP

Отредактируйте ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "apple-calendar": {
      "command": "uv",
      "args": ["run", "--project", "/path/to/claude-connector-apple-calendar", "apple-calendar-mcp"]
    }
  }
}

Разрешения

При первом вызове инструмента Calendar macOS предложит вам предоставить доступ к Календарям. Выберите Полный доступ — предоставление «Только добавление» в macOS 14+ не позволяет читать события, поэтому каждый инструмент чтения (и чтение после каждой записи) завершится ошибкой.

Если запрос не появляется (что может случиться с неподписанными интерпретаторами, запускаемыми как дочерние процессы):

1. Откройте Системные настройки → Конфиденциальность и безопасность → Календари

2. Добавьте Claude Desktop (или процесс, запускающий uv) и включите Полный доступ

3. Завершите и перезапустите Claude Desktop

Чтобы проверить статус доступа, выполните:

sqlite3 ~/Library/Application\ Support/com.apple.TCC/TCC.db \
  "SELECT client, auth_value FROM access WHERE service='kTCCServiceCalendar'"

(auth_value равный 2 = полный доступ, 0 = отказано.)

Примеры использования

После установки просто задайте вопрос Клоду естественным языком:

• «Что у меня сегодня в календаре?»

• «Когда я свободен на час завтра днём?»

• «Запланируй обед с Сэмом в пятницу в полдень в Zuni Café.»

• «Перенеси мою встречу с 15:00 на 16:30 и сделай её 45 минут.»

• «Настрой еженедельную синхронизацию команды каждый вторник в 10:00 на следующие 8 недель.»

• «Отмени только стендап в следующий понедельник, остальную серию сохрани.»

• «Добавь напоминание за 10 минут до моего визита к стоматологу.»

• «Кто ещё не ответил на приглашение на выездное мероприятие?»

• «Создай календарь "Путешествия" и помести туда мой маршрут полёта.»

Сборка из исходников

# Install mcpb CLI (one time)
npm install -g @anthropic-ai/mcpb

# Install uv (one time, if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Build the extension
./build.sh

# Or manually:
mcpb validate manifest.json
mcpb pack . dist/apple-calendar.mcpb

Структура проекта

claude-connector-apple-calendar/
├── manifest.json                    # MCPB desktop extension manifest
├── icon.png                         # Calendar.app icon (512x512)
├── icons/                           # Multi-size icons
│   ├── icon-128.png
│   ├── icon-256.png
│   └── icon-512.png
├── pyproject.toml                   # Python package + dependencies
├── build.sh                         # Validate + pack build script (gates on version drift)
├── tools/                           # Dev-only icon extraction (not packed)
├── tests/
│   └── test_e2e.py                  # End-to-end tests
└── src/
    └── apple_calendar_mcp/
        ├── __init__.py
        ├── server.py                # MCP tools (MCPServer)
        ├── calendars.py             # EventKit-backed CalendarStore
        ├── permissions.py           # TCC grant helpers
        └── models.py                # Pydantic data models

Тесты

# Static tests (model shapes, validation, helpers — no permission needed)
uv run python tests/test_e2e.py --skip-live

# Full suite (requires Calendar permission)
uv run python tests/test_e2e.py

Живые тесты работают с выделенным календарём __claude_mcp_test__, который создаётся при настройке и удаляется в конце.

Безопасность и конфиденциальность

• Все данные остаются на вашем Mac — это локальный MCP-сервер. EventKit читает из того же хранилища, что и Calendar.app, включая календари, синхронизированные с iCloud/Google/Exchange.

• Операции контролируются macOS TCC: ничего не происходит, пока вы не предоставите доступ к Календарю.

• Только macOS ("platforms": ["darwin"] в манифесте).

• Коннектор никогда не выходит за пределы сущности Calendar — никаких Напоминаний, контактов или файлов.

• Деструктивные операции (delete_calendar, delete_event) — это явные инструменты, которые модель должна выбрать для вызова; они не выполняются как побочные эффекты чтения.

• Создание или изменение событий никогда не отправляет приглашения по электронной почте — публичный API EventKit не может добавлять участников, поэтому ничего не покидает ваш компьютер.

Устранение неполадок

«Доступ к Apple Calendar не был предоставлен» Откройте Системные настройки → Конфиденциальность и безопасность → Календари, убедитесь, что Claude Desktop указан с Полным доступом (не «Только добавление»), затем перезапустите Claude Desktop.

Запрос разрешения не появляется Неподписанные интерпретаторы Python, запускаемые Claude Desktop, иногда не вызывают запрос автоматически. Добавьте Claude Desktop вручную в Системные настройки → Конфиденциальность и безопасность → Календари.

События за пределами ~4 лет не отображаются Предикат событий EventKit охватывает максимум 4 года на запрос. Коннектор автоматически разбивает более широкие диапазоны, но очень широкие диапазоны будут медленными — предпочитайте более узкие окна.

Изменение повторяющегося события затронуло всю серию Передайте occurrence_date (из list_events), чтобы выбрать одно вхождение, и сохраните span='this_event'. span='future_events' намеренно перезаписывает это вхождение и все последующие.

Может ли Клод приглашать людей на встречу? Нет — публичный API EventKit предоставляет участников только для чтения. Клод может прочитать, кто приглашён и как они ответили, но добавлять приглашённых вы будете в Calendar.app.

Расширение не появляется после установки Убедитесь, что вы используете последнюю версию Claude Desktop с поддержкой расширений MCPB. Перезапустите Claude Desktop после установки.

Дорожная карта

v1 — выпущено

• Список, создание, переименование, удаление календарей

• Список, поиск, получение событий с фильтрами и пагинацией

• Создание, обновление, удаление событий (с учётом span для повторяющихся серий)

• Повторяемость (ежедневно/еженедельно/ежемесячно/ежегодно с интервалами, по дням, по месяцам, заданные позиции, условия окончания)

• Напоминания (относительные, абсолютные)

• Структурированные (геокодированные) местоположения

• Чтение участников и организатора с указанием статуса ответа

• Доступность free/busy с объединением интервалов

• Глубокие ссылки ical://

v2 — рассматривается

• RSVP / ответ на приглашение (заблокировано публичным API EventKit)

• Чтение времени в пути и URL конференций, где EventKit их предоставляет

• Массовые операции (перемещение/удаление нескольких событий)

• Естественный помощник «найди слот для N человек» на основе get_availability

Лицензия

MIT