iCloud MCP — MCP-сервер для Claude Code: что делает и установка
Подключает ассистента к сервисам Apple: почте, календарю, заметкам и напоминаниям. Помогает управлять личными данными прямо из чата с моделью.
claude mcp add --env USE_LOCAL_MODE=<USE_LOCAL_MODE> --env ICLOUD_EMAIL=<ICLOUD_EMAIL> --env ICLOUD_APP_PASSWORD=<ICLOUD_APP_PASSWORD> --transport stdio icloud-mcp -- npx -y mcp-icloudЧто делает iCloud MCP
Сервер открывает доступ к семи сервисам экосистемы Apple через 41 инструмент. Он работает в двух режимах. Локальный вариант на macOS управляет штатными программами через AppleScript без ввода паролей учётной записи. Сетевой вариант подключается по протоколам IMAP, SMTP, CalDAV и CardDAV, поэтому его можно запускать и на других операционных системах.
Переключение между локальной и облачной работой выполняется на лету командой set-mode. Вся связь идёт через стандартные потоки ввода-вывода JSON-RPC без открытия сетевых портов на машине. Для чтения переписки в Messages локально потребуется отдельная утилита imsg и системное право Full Disk Access.
Какие задачи решает
- искать письма и отправлять ответы через Apple Mail
- создавать события в календаре с точным временем начала и конца
- вести списки дел и закрывать выполненные пункты в Reminders
- находить телефон или почту человека в контактах
Примеры запросов агенту
- Найди в календаре все встречи на ближайшие три дня
- Создай в приложении Reminders задачу проверить сервер со сроком на завтра
- Поищи среди непрочитанных писем сообщения от бухгалтерии
Как установить iCloud MCP
Командой платформы
claude mcp add --env USE_LOCAL_MODE=<USE_LOCAL_MODE> --env ICLOUD_EMAIL=<ICLOUD_EMAIL> --env ICLOUD_APP_PASSWORD=<ICLOUD_APP_PASSWORD> --transport stdio icloud-mcp -- npx -y mcp-icloudВместо <…> подставьте свои значения
Командой платформы
codex mcp add icloud-mcp --env USE_LOCAL_MODE=<USE_LOCAL_MODE> --env ICLOUD_EMAIL=<ICLOUD_EMAIL> --env ICLOUD_APP_PASSWORD=<ICLOUD_APP_PASSWORD> -- npx -y mcp-icloudВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"icloud-mcp": {
"command": "npx",
"args": [
"-y",
"mcp-icloud"
],
"env": {
"USE_LOCAL_MODE": "<USE_LOCAL_MODE>",
"ICLOUD_EMAIL": "<ICLOUD_EMAIL>",
"ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"icloud-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-icloud"
],
"env": {
"USE_LOCAL_MODE": "<USE_LOCAL_MODE>",
"ICLOUD_EMAIL": "<ICLOUD_EMAIL>",
"ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e USE_LOCAL_MODE=<USE_LOCAL_MODE> -e ICLOUD_EMAIL=<ICLOUD_EMAIL> -e ICLOUD_APP_PASSWORD=<ICLOUD_APP_PASSWORD> icloud-mcp npx -y mcp-icloudВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о iCloud MCP
Как установить iCloud MCP в Claude Code?
Для запуска выполните команду claude mcp add icloud-mcp -e ICLOUD_APP_PASSWORD=<ICLOUD_APP_PASSWORD> -- npx -y mcp-icloud. Либо укажите полный набор параметров: `claude mcp add --env USE_LOCAL_MODE=<USE_LOCAL_MODE> --env ICLOUD_EMAIL=<ICLOUD_EMAIL> --env ICLOUD_APP_PASSWORD=<ICLOUD_APP_PASSWORD> --transport stdio icloud-mcp -- npx -y mcp-icloud`.
Что делает iCloud MCP?
Предоставляет ИИ-ассистенту инструменты для взаимодействия с календарями, контактами, письмами, заметками и напоминаниями. Запросы обрабатываются либо через системные скрипты macOS, либо по стандартным протоколам iCloud.
Чем локальный режим отличается от облачного?
В локальном режиме запросы передаются приложениям через AppleScript, что открывает доступ к Reminders, Safari и Notes без ввода паролей. Облачный режим опирается на IMAP, CalDAV и CardDAV, работает на любых платформах, но не поддерживает сервисы, не представленные в открытых протоколах.
