Apple Calendar · mgcrea — MCP-сервер для Claude Code: чтение и запись событий
Даёт агенту доступ к календарю на macOS: поиск событий, свободные окна, создание и правка записей. Запись по умолчанию выключена.
claude mcp add --env APPLE_CALENDAR_ALLOW_WRITES=<APPLE_CALENDAR_ALLOW_WRITES> --env APPLE_CALENDAR_CALENDARS=<APPLE_CALENDAR_CALENDARS> --env APPLE_CALENDAR_ACCOUNTS=<APPLE_CALENDAR_ACCOUNTS> --transport stdio calendar -- npx -y @mgcrea/mcp-apple-calendarЧто делает Apple Calendar
Сервер читает базу календаря, которая уже лежит на Mac, и отдаёт агенту список аккаунтов, календарей и событий. Поиск идёт по диапазону дат, есть отдельный инструмент для свободных окон. Запись включается переменной APPLE_CALENDAR_ALLOW_WRITES=1 — без неё инструменты создания, правки и удаления модель вообще не видит.
Чтение и запись разведены по разным каналам. Все чтения идут через SQLite в режиме только для чтения, записи — через Apple Events. Для чтения нужно Full Disk Access у того процесса, который запускает сервер: Terminal, iTerm, VS Code. Без этого разрешения не работает ничего, запасного пути чтения нет. Разрешение Automation → Calendar нужно только для записи, и при выключенной записи запрос на него не появится.
Есть нюансы, о которые легко споткнуться. База лежит не в ~/Library/Calendars, а в ~/Library/Group Containers/group.com.apple.calendar/Calendar.sqlitedb. Повторяющиеся события хранятся в кэш-таблице, поэтому наивный запрос по диапазону пропускает развёрнутые повторы. Даты внутри — секунды с 2001 года, а не с 1970. Диапазон по умолчанию — 7 дней, потолок для запроса — 366.
Какие задачи решает
- найти свободное окно на неделе
- вытащить все встречи за месяц
- создать событие в нужном календаре
- проверить, что попало в расписание после переноса
- удалить отменённые встречи пачкой
Примеры запросов агенту
- Покажи мои встречи на завтра
- Найди свободные два часа в четверг после обеда
- Создай событие «Созвон с командой» в календаре Work на 15:00
Как установить Apple Calendar
Командой платформы
claude mcp add --env APPLE_CALENDAR_ALLOW_WRITES=<APPLE_CALENDAR_ALLOW_WRITES> --env APPLE_CALENDAR_CALENDARS=<APPLE_CALENDAR_CALENDARS> --env APPLE_CALENDAR_ACCOUNTS=<APPLE_CALENDAR_ACCOUNTS> --transport stdio calendar -- npx -y @mgcrea/mcp-apple-calendarВместо <…> подставьте свои значения
Командой платформы
codex mcp add calendar --env APPLE_CALENDAR_ALLOW_WRITES=<APPLE_CALENDAR_ALLOW_WRITES> --env APPLE_CALENDAR_CALENDARS=<APPLE_CALENDAR_CALENDARS> --env APPLE_CALENDAR_ACCOUNTS=<APPLE_CALENDAR_ACCOUNTS> -- npx -y @mgcrea/mcp-apple-calendarВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"calendar": {
"command": "npx",
"args": [
"-y",
"@mgcrea/mcp-apple-calendar"
],
"env": {
"APPLE_CALENDAR_ALLOW_WRITES": "<APPLE_CALENDAR_ALLOW_WRITES>",
"APPLE_CALENDAR_CALENDARS": "<APPLE_CALENDAR_CALENDARS>",
"APPLE_CALENDAR_ACCOUNTS": "<APPLE_CALENDAR_ACCOUNTS>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"calendar": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mgcrea/mcp-apple-calendar"
],
"env": {
"APPLE_CALENDAR_ALLOW_WRITES": "<APPLE_CALENDAR_ALLOW_WRITES>",
"APPLE_CALENDAR_CALENDARS": "<APPLE_CALENDAR_CALENDARS>",
"APPLE_CALENDAR_ACCOUNTS": "<APPLE_CALENDAR_ACCOUNTS>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e APPLE_CALENDAR_ALLOW_WRITES=<APPLE_CALENDAR_ALLOW_WRITES> -e APPLE_CALENDAR_CALENDARS=<APPLE_CALENDAR_CALENDARS> -e APPLE_CALENDAR_ACCOUNTS=<APPLE_CALENDAR_ACCOUNTS> calendar npx -y @mgcrea/mcp-apple-calendarВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Apple Calendar
Как установить Apple Calendar в Claude Code?
Одной командой: claude mcp add mcp-apple-calendar -- npx -y @mgcrea/mcp-apple-calendar. Если нужны переменные окружения, есть второй вариант: `claude mcp add --env APPLE_CALENDAR_ALLOW_WRITES=<APPLE_CALENDAR_ALLOW_WRITES> --env APPLE_CALENDAR_CALENDARS=<APPLE_CALENDAR_CALENDARS> --env APPLE_CALENDAR_ACCOUNTS=<APPLE_CALENDAR_ACCOUNTS> --transport stdio calendar -- npx -y @mgcrea/mcp-apple-calendar`.
Что делает Apple Calendar?
Читает календарь macOS и отдаёт агенту аккаунты, календари и события, умеет искать по диапазону дат и находить свободное время. С включённой записью создаёт, правит и удаляет события.
Какие разрешения нужны для работы?
Full Disk Access — тому процессу, из которого запускается сервер, иначе чтение не заработает. Automation → Calendar нужен только для записи.
Похожие MCP-серверы
Все MCP-серверы по теме «Заметки, задачи и проекты» →Сначала — Apple Calendar от других авторов.
