icloud-mcp
MCP-сервер для почты, календаря, контактов, напоминаний, заметок и Safari: локально через macOS или по протоколам iCloud.
- 80 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Инструменты читают почту, сообщения и заметки, отправляют письма и удаляют события, контакты и напоминания в вашем аккаунте.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/icloud-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Инструменты читают почту, сообщения и заметки, отправляют письма и удаляют события, контакты и напоминания в вашем аккаунте.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту 41 инструмент для семи сервисов Apple. В локальном режиме он управляет встроенными приложениями macOS через AppleScript: пароли и сеть не требуются, и доступны даже сервисы, которых нет в протоколах iCloud: напоминания, заметки, сообщения и Safari. В облачном режиме сервер работает по IMAP, SMTP, CalDAV и CardDAV и запускается на любой машине, не только на Mac. Инструмент `set-mode` переключает режимы на ходу, без перезапуска. Среди инструментов `send-email`, `delete-event`, `update-event`, `delete-contact` и `delete-reminder`. Чтение (`list-*`, `read-*`, `search-*`, `get-*`) помечено как безопасное, а запись и удаление размечены явно, чтобы клиент мог запрашивать подтверждение. Сервер общается только по stdin и stdout, портов не открывает и телеметрии не ведет.
Для кого. Пользователям Mac и iCloud, которые хотят разбирать почту, назначать встречи и вести заметки и напоминания из Claude Code, Cursor или Claude Desktop.
Подходит, если
- Агент находит в почте письма по теме и составляет ответ, а вы подтверждаете отправку.
- Встречи на неделю переносят в календаре одной просьбой.
- Список напоминаний на сегодня собирается из нескольких списков.
- Контакты ищут по организации и правят данные одним запросом.
Не подходит, если
- Нужен доступ к чужим ящикам и календарям: сервер рассчитан на ваш аккаунт.
- У вас не Mac и нет пароля приложения iCloud.
- Письма и сообщения нельзя показывать модели.
Пример запроса к агенту
Покажи письма за последние три дня от клиентов, подготовь ответ на самое срочное и добавь напоминание на завтра.MCP
- Транспорт
- stdio
- Авторизация
- ключ необязателен
Переменные окружения
USE_LOCAL_MODE- Значение `false` включает облачный режим.
ICLOUD_EMAIL- Адрес iCloud для облачного режима.
ICLOUD_APP_PASSWORDсекрет- Пароль приложения Apple для облачного режима.
Ограничения
Локальный режим работает только на macOS: при первом обращении к приложению система спрашивает разрешение на управление им, а для чтения сообщений нужны доступ к диску и утилита `imsg`. Облачный режим требует `USE_LOCAL_MODE=false`, `ICLOUD_EMAIL` и пароль приложения в `ICLOUD_APP_PASSWORD`, его создают на account.apple.com. Нужен Node.js 20 или новее. Инструменты умеют отправлять письма и удалять данные, а повторяющиеся события в локальном режиме меняются целиком по идентификатору серии. Содержимое писем и заметок попадает модели, поэтому используйте клиент с подтверждением действий.
Как отключить. Удалите запись `icloud` из конфигурации клиента или выполните `claude mcp remove icloud`. Разрешения на управление приложениями отзывают в настройках macOS, пароль приложения Apple удаляют на account.apple.com.
Частые вопросы
Как подключить к Claude Code?
Выполните `claude mcp add --transport stdio icloud -- npx -y mcp-icloud`. В других клиентах добавьте сервер `icloud` с командой `npx` и аргументами `-y mcp-icloud`.
Чем локальный режим отличается от облачного?
Локальный режим управляет приложениями Mac без паролей и видит заметки, сообщения, напоминания и Safari. Облачный использует протоколы iCloud и идет с любой машины, но этих сервисов не покрывает.
Где хранится пароль приложения?
В файле `.env` рядом с модулем или в связке ключей macOS, если ставить пакет `.mcpb`. Значение не пишется в журналы.
Почему вызов отвечает ошибкой авторизации?
Вы закрыли запрос macOS на управление приложением. Включите нужный флажок в разделе Автоматизация настроек конфиденциальности, ошибка `-1743` исчезнет.
Что собирает сервер?
Ничего: нет телеметрии, аналитики и состояния на диске. Данные идут между вашей машиной, подключенным клиентом и сервисами Apple.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для Apple Mail на macOS: чтение, поиск, отправка и разбор почты через AppleScript или IMAP и SMTP.
imap-mcp-server — почта по IMAP и SMTP для агента
imap-mcp-server
MCP-сервер дает агенту искать, читать, отправлять и чистить письма в нескольких ящиках, а пароли хранит под шифрованием AES-256
MCP-сервер к почте на Mac: агент читает, ищет, пишет, сортирует письма и разбирает ящик, есть режим только для чтения
MCP-сервер для Apple Mail на macOS: поиск, чтение, черновики, правила и вложения, опасные шаги с подтверждением.
Локальный MCP-сервер для Mac и Windows: агент работает с почтой, мессенджерами, календарем и файлами.
MCP-сервер для Apple Mail на macOS: 8 инструментов чтения и поиск по телу писем через индекс FTS5 на больших ящиках
Коротко о README
Описаны два режима работы, модель доступа и безопасности, политика конфиденциальности, полный список инструментов с параметрами, установка тремя способами и переменные окружения. Отдельные разделы объясняют запросы macOS и EventKit.