MCP-сервер Fantastical

MCP-сервер для Fantastical — мощного приложения-календаря для macOS.

Зачем это нужно?

• Создание событий на естественном языке — используйте мощный парсинг естественного языка Fantastical («Встреча с Джоном завтра в 15:00»)

• Просмотр расписания — проверяйте события на сегодня или предстоящие встречи, не покидая диалог

• Быстрый доступ к календарю — мгновенный переход к любой дате в Fantastical

• ИИ с доступом к календарю — позвольте Claude понимать вашу занятость и контекст расписания

• Нулевая настройка — работает с уже настроенными Fantastical и «Календарем»

Related MCP server: Apple Calendar MCP Server

Возможности

Системные требования

• macOS (Fantastical доступен только на macOS)

• Node.js 18+

• Установленный Fantastical

• Разрешения на доступ к календарю для Терминала/Claude

Установка

Через npm (рекомендуется)

npx mcp-fantastical

Из исходного кода

git clone https://github.com/aplaceforallmystuff/mcp-fantastical.git
cd mcp-fantastical
npm install
npm run build

Конфигурация

API-ключи не требуются — этот сервер использует AppleScript для взаимодействия с Fantastical и приложением «Календарь».

Для Claude Desktop

Добавьте в файл конфигурации Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "fantastical": {
      "command": "npx",
      "args": ["-y", "mcp-fantastical"]
    }
  }
}

Для Claude Code

Добавьте в ~/.claude.json:

{
  "mcpServers": {
    "fantastical": {
      "command": "npx",
      "args": ["-y", "mcp-fantastical"]
    }
  }
}

Разрешения

При первом запуске может потребоваться предоставить следующие разрешения:

Универсальный доступ (для создания событий через URL-схему):

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

2. Добавьте Терминал (или ваше приложение терминала) в список разрешенных

Полный доступ к календарю (для чтения событий):

Вспомогательный компонент поставляется в виде подписанного пакета .app (FantasticalHelper.app). При первом обращении MCP-сервера к данным календаря macOS покажет однократный запрос от имени «FantasticalHelper» с просьбой предоставить полный доступ к календарю. Подтвердите его.

Если вы пропустили запрос или нужно предоставить доступ позже:

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

2. Включите FantasticalHelper

Примечание: Предыдущие версии поставлялись с необработанным вспомогательным бинарным файлом, для которого macOS не могла назначить разрешение TCC при запуске через Claude Desktop — запрос не появлялся, и доступ молча отклонялся (#6). Входящий в комплект подписанный помощник решает эту проблему.

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

Создание событий

• «Запланируй встречу с командой завтра в 14:00»

• «Добавь прием у стоматолога в пятницу в 10 утра в мой личный календарь»

• «Создай повторяющуюся летучку каждый понедельник в 9 утра»

• «Заблокируй время в следующий вторник после обеда для глубокой работы»

Просмотр расписания

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

• «Покажи мое расписание на следующую неделю»

• «Какие встречи у меня завтра?»

• «Свободен ли я в пятницу после обеда?»

Навигация

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

• «Покажи мне 25 декабря в Fantastical»

• «Перейди на следующую неделю в моем календаре»

Поиск

• «Найди все встречи с Сарой»

• «Поищи приемы у стоматолога»

• «Найди встречи по обзору проекта»

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

Разработка

# Watch mode for development
npm run watch

# Build TypeScript
npm run build

# Run locally
node dist/index.js

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

«AppleScript error: Not authorized to send Apple events»

Предоставьте разрешения универсального доступа:

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

2. Нажмите на замок, чтобы внести изменения

3. Добавьте Терминал (или ваше приложение терминала) и включите его

Ошибки доступа к календарю или «Calendar access denied» в Claude Desktop

Разрешения macOS TCC не наследуются через цепочку Claude Desktop → npx → node → helper. Вспомогательный компонент упакован в подписанный пакет FantasticalHelper.app, чтобы macOS могла идентифицировать его и назначить разрешение на доступ к календарю.

Решения:

1. Найдите однократный системный запрос от имени FantasticalHelper и подтвердите его. Если он появился за другим окном, перезапустите MCP-клиент и повторите попытку.

2. Проверьте Системные настройки → Конфиденциальность и безопасность → Календари и включите FantasticalHelper.

3. При запуске из исходного кода пересоберите пакет: npm run build:native.

4. Если пакет по какой-то причине не имеет подписи, подпишите его заново: codesign --force --sign - dist/native/FantasticalHelper.app.

«Error: This MCP server only works on macOS»

Этому серверу требуется macOS, так как Fantastical — это приложение для macOS. Он использует AppleScript для взаимодействия с Fantastical и приложением «Календарь».

События не отображаются

• Убедитесь, что Fantastical синхронизируется с iCloud/Календарем

• Проверьте, что приложение «Календарь» имеет доступ к тем же календарям

• Убедитесь, что событие было создано в правильном календаре

• Предоставьте полный доступ к календарю (см. выше)

Fantastical не открывается

• Убедитесь, что Fantastical установлен

• Попробуйте открыть Fantastical вручную

• Проверьте, включены ли URL-схемы в настройках Fantastical

Лицензия

MIT — подробности см. в LICENSE.

Ссылки

• Fantastical — официальный сайт Fantastical

• Model Context Protocol — спецификация MCP

• Репозиторий на GitHub