iCloud — MCP-сервер для Claude Code: функции и установка
Подключает iCloud к ИИ-агенту: тот может искать письма, работать с календарём и находить файлы в iCloud Drive. Запросы на отправку писем требуют подтверждения.
claude mcp add --env ICLOUD_USERNAME=<ICLOUD_USERNAME> --env ICLOUD_APP_PASSWORD=<ICLOUD_APP_PASSWORD> --env ICLOUD_DISPLAY_NAME=<ICLOUD_DISPLAY_NAME> --env DEFAULT_TIMEZONE=<DEFAULT_TIMEZONE> --env SEND_REQUIRES_APPROVAL=<SEND_REQUIRES_APPROVAL> --transport stdio icloud -- uvx icloud-mcp-serverЧто делает iCloud
MCP-сервер даёт агенту доступ к iCloud Mail, Calendar, Contacts, Reminders, Notes и iCloud Drive. Можно искать письма и файлы, проверять свободное время и работать с напоминаниями. Также доступны Maps и Messages; отправка сообщений выключена по умолчанию.
Сервер запускается локально или размещается на собственном сервере. Для входа используются имя пользователя iCloud и пароль приложения; пароль хранится на вашей машине. Письма перед отправкой ждут подтверждения или сохраняются в черновики, а приглашения другим людям отключены. Без пароля приложения подключение к аккаунту не настроить.
Какие задачи решает
- найти письмо по теме или отправителю
- проверить свободное время в календаре
- найти документ в iCloud Drive
- создать напоминание на заданную дату
- подготовить ответ на письмо с подтверждением перед отправкой
Примеры запросов агенту
- Найди письмо от арендодателя о ремонте и подготовь вежливый ответ.
- Проверь, когда у меня есть свободный час на следующей неделе.
- Найди налоговую декларацию в iCloud Drive и расскажи, сколько я заплатил в прошлом году.
Как установить iCloud
Командой платформы
claude mcp add --env ICLOUD_USERNAME=<ICLOUD_USERNAME> --env ICLOUD_APP_PASSWORD=<ICLOUD_APP_PASSWORD> --env ICLOUD_DISPLAY_NAME=<ICLOUD_DISPLAY_NAME> --env DEFAULT_TIMEZONE=<DEFAULT_TIMEZONE> --env SEND_REQUIRES_APPROVAL=<SEND_REQUIRES_APPROVAL> --transport stdio icloud -- uvx icloud-mcp-serverВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from icloud-mcp-server <команда>
Командой платформы
codex mcp add icloud --env ICLOUD_USERNAME=<ICLOUD_USERNAME> --env ICLOUD_APP_PASSWORD=<ICLOUD_APP_PASSWORD> --env ICLOUD_DISPLAY_NAME=<ICLOUD_DISPLAY_NAME> --env DEFAULT_TIMEZONE=<DEFAULT_TIMEZONE> --env SEND_REQUIRES_APPROVAL=<SEND_REQUIRES_APPROVAL> -- uvx icloud-mcp-serverВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from icloud-mcp-server <команда>
Файл настроек
{
"mcpServers": {
"icloud": {
"command": "uvx",
"args": [
"icloud-mcp-server"
],
"env": {
"ICLOUD_USERNAME": "<ICLOUD_USERNAME>",
"ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>",
"ICLOUD_DISPLAY_NAME": "<ICLOUD_DISPLAY_NAME>",
"DEFAULT_TIMEZONE": "<DEFAULT_TIMEZONE>",
"SEND_REQUIRES_APPROVAL": "<SEND_REQUIRES_APPROVAL>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from icloud-mcp-server <команда>
Файл настроек
{
"servers": {
"icloud": {
"type": "stdio",
"command": "uvx",
"args": [
"icloud-mcp-server"
],
"env": {
"ICLOUD_USERNAME": "<ICLOUD_USERNAME>",
"ICLOUD_APP_PASSWORD": "<ICLOUD_APP_PASSWORD>",
"ICLOUD_DISPLAY_NAME": "<ICLOUD_DISPLAY_NAME>",
"DEFAULT_TIMEZONE": "<DEFAULT_TIMEZONE>",
"SEND_REQUIRES_APPROVAL": "<SEND_REQUIRES_APPROVAL>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from icloud-mcp-server <команда>
Командой платформы
gemini mcp add -e ICLOUD_USERNAME=<ICLOUD_USERNAME> -e ICLOUD_APP_PASSWORD=<ICLOUD_APP_PASSWORD> -e ICLOUD_DISPLAY_NAME=<ICLOUD_DISPLAY_NAME> -e DEFAULT_TIMEZONE=<DEFAULT_TIMEZONE> -e SEND_REQUIRES_APPROVAL=<SEND_REQUIRES_APPROVAL> icloud uvx icloud-mcp-serverВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from icloud-mcp-server <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о iCloud
Как установить iCloud в Claude Code?
Выполните claude mcp add icloud-mcp -e ICLOUD_USERNAME=<ICLOUD_USERNAME> -e ICLOUD_APP_PASSWORD=<ICLOUD_APP_PASSWORD> -- uvx icloud-mcp-server. Укажите имя пользователя iCloud и пароль приложения.
Что делает iCloud?
Подключает MCP-клиент к почте, календарю, контактам, напоминаниям, заметкам и iCloud Drive. Агент может искать данные и выполнять действия с ними.
Нужен ли пароль приложения для подключения?
Да. Для входа в сервисы используется пароль приложения, который хранится на вашей машине.
