icloud-calendar-mcp — MCP-сервер для Claude Code: что умеет и запуск
Подключает ИИ-ассистентов к календарю iCloud через CalDAV. Позволяет просматривать расписание, создавать, двигать и удалять события прямо в чате.
claude mcp add icloud-calendar-mcp -e ICLOUD_USERNAME=<ICLOUD_USERNAME> -e ICLOUD_PASSWORD=<ICLOUD_PASSWORD> -- npx -y @icloud-calendar-mcp/serverЧто делает icloud-calendar-mcp
Сервер связывает агента с Apple Calendar напрямую по протоколу CalDAV, поэтому macOS или запущенная программа «Календарь» не нужны. Инструмент умеет читать списки календарей через list_calendars, искать события в диапазоне дат, а также создавать и менять записи. Повторяющиеся события можно редактировать целиком или по отдельным датам.
Внутри работает Java-приложение, упакованное в обёртку для npm и Python. Главное требование: в системе обязательно должна быть установлена Java 21 или новее, иначе запуск через npx завершится ошибкой.
Для авторизации требуется отдельный пароль приложения Apple ID, основной пароль от аккаунта использовать нельзя. В сервер заложены лимиты: 60 чтений и 20 записей в минуту, а также проверки входных данных на SSRF и защита от ReDoS.
Какие задачи решает
- получать расписание из iCloud на выбранный диапазон дат
- находить пересечения во встречах через встроенные промпты
- переносить или удалять отдельные повторы регулярных встреч
- вносить новые события в календарь Apple без открытого клиента
Примеры запросов агенту
- Покажи список моих календарей в iCloud
- Проверь расписание на завтра и найди пересечения во встречах
- Создай встречу с командой в пятницу в 14:00 на один час
Как установить icloud-calendar-mcp
Командой платформы
claude mcp add icloud-calendar-mcp -e ICLOUD_USERNAME=<ICLOUD_USERNAME> -e ICLOUD_PASSWORD=<ICLOUD_PASSWORD> -- npx -y @icloud-calendar-mcp/serverВместо <…> подставьте свои значения
Командой платформы
codex mcp add icloud-calendar-mcp --env ICLOUD_USERNAME=<ICLOUD_USERNAME> --env ICLOUD_PASSWORD=<ICLOUD_PASSWORD> -- npx -y @icloud-calendar-mcp/serverВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"icloud-calendar-mcp": {
"command": "npx",
"args": [
"-y",
"@icloud-calendar-mcp/server"
],
"env": {
"ICLOUD_USERNAME": "<ICLOUD_USERNAME>",
"ICLOUD_PASSWORD": "<ICLOUD_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"icloud-calendar-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@icloud-calendar-mcp/server"
],
"env": {
"ICLOUD_USERNAME": "<ICLOUD_USERNAME>",
"ICLOUD_PASSWORD": "<ICLOUD_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e ICLOUD_USERNAME=<ICLOUD_USERNAME> -e ICLOUD_PASSWORD=<ICLOUD_PASSWORD> icloud-calendar-mcp npx -y @icloud-calendar-mcp/serverВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о icloud-calendar-mcp
Как установить icloud-calendar-mcp в Claude Code?
Выполните команду claude mcp add icloud-calendar-mcp -e ICLOUD_USERNAME=<ICLOUD_USERNAME> -e ICLOUD_PASSWORD=<ICLOUD_PASSWORD> -- npx -y @icloud-calendar-mcp/server. Замените плейсхолдеры на почту Apple ID и созданный пароль приложения.
Что делает icloud-calendar-mcp?
Сервер даёт агенту инструменты для чтения календарей, выборки событий по датам, добавления записей и корректировки встреч в iCloud через протокол CalDAV.
Нужен ли Mac для работы с этим сервером?
Нет, привязки к macOS или AppleScript нет. Сервер работает на любой операционной системе, где установлена Java 21.
