Apple Mail · mgcrea — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер для macOS подключает локальное приложение Apple Mail к ИИ-агентам. Позволяет искать письма, читать цепочки и работать с почтой без передачи паролей IMAP во внешнюю сеть.
claude mcp add --env APPLE_MAIL_ALLOW_WRITES=<APPLE_MAIL_ALLOW_WRITES> --env APPLE_MAIL_ACCOUNTS=<APPLE_MAIL_ACCOUNTS> --env APPLE_MAIL_ALLOW_FILE_SEND=<APPLE_MAIL_ALLOW_FILE_SEND> --transport stdio mail -- npx -y @mgcrea/mcp-apple-mailЧто делает Apple Mail
Сервер связывает агента с локальной почтовой базой macOS без передачи логинов и паролей IMAP во внешние сервисы. Задачи разделены по трём каналам: запросы списков папок и действия отправляются через AppleScript, а быстрый поиск идёт прямо по локальному файлу SQLite Envelope Index. Тексты писем и вложения считываются напрямую из файлов .emlx.
Для работы требуются два системных разрешения: доступ к автоматизации Mail и Full Disk Access. Без доступа к диску поиск и чтение тел писем заблокированы, хотя базовые списки сработают. Чтобы не выдавать права на весь диск редактору кода, автор предлагает запускать сервер через подписанное меню-приложение Cupertino (brew install --cask mgcrea/tap/cupertino).
По умолчанию любые изменения почты отключены параметром APPLE_MAIL_ALLOW_WRITES="0", поэтому агент не сможет отправить или удалить письмо без явного разрешения. В спорных ситуациях статус системных прав проверяет встроенная команда apple_mail_diagnostics.
Какие задачи решает
- найти цепочки писем через локальный индекс SQLite
- прочитать текст сообщения и извлечь вложения из файлов
.emlx - узнать число непрочитанных сообщений в почтовых ящиках
- отправлять почту через AppleScript при включённых правах на запись
Примеры запросов агенту
- Проверь через
apple_mail_diagnostics, есть ли у тебя доступ к почте macOS - Покажи список моих почтовых ящиков и количество новых писем
- Найди письма от бухгалтерии за прошлую неделю и выведи их темы
Как установить Apple Mail
Командой платформы
claude mcp add --env APPLE_MAIL_ALLOW_WRITES=<APPLE_MAIL_ALLOW_WRITES> --env APPLE_MAIL_ACCOUNTS=<APPLE_MAIL_ACCOUNTS> --env APPLE_MAIL_ALLOW_FILE_SEND=<APPLE_MAIL_ALLOW_FILE_SEND> --transport stdio mail -- npx -y @mgcrea/mcp-apple-mailВместо <…> подставьте свои значения
Командой платформы
codex mcp add mail --env APPLE_MAIL_ALLOW_WRITES=<APPLE_MAIL_ALLOW_WRITES> --env APPLE_MAIL_ACCOUNTS=<APPLE_MAIL_ACCOUNTS> --env APPLE_MAIL_ALLOW_FILE_SEND=<APPLE_MAIL_ALLOW_FILE_SEND> -- npx -y @mgcrea/mcp-apple-mailВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"mail": {
"command": "npx",
"args": [
"-y",
"@mgcrea/mcp-apple-mail"
],
"env": {
"APPLE_MAIL_ALLOW_WRITES": "<APPLE_MAIL_ALLOW_WRITES>",
"APPLE_MAIL_ACCOUNTS": "<APPLE_MAIL_ACCOUNTS>",
"APPLE_MAIL_ALLOW_FILE_SEND": "<APPLE_MAIL_ALLOW_FILE_SEND>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"mail": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mgcrea/mcp-apple-mail"
],
"env": {
"APPLE_MAIL_ALLOW_WRITES": "<APPLE_MAIL_ALLOW_WRITES>",
"APPLE_MAIL_ACCOUNTS": "<APPLE_MAIL_ACCOUNTS>",
"APPLE_MAIL_ALLOW_FILE_SEND": "<APPLE_MAIL_ALLOW_FILE_SEND>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e APPLE_MAIL_ALLOW_WRITES=<APPLE_MAIL_ALLOW_WRITES> -e APPLE_MAIL_ACCOUNTS=<APPLE_MAIL_ACCOUNTS> -e APPLE_MAIL_ALLOW_FILE_SEND=<APPLE_MAIL_ALLOW_FILE_SEND> mail npx -y @mgcrea/mcp-apple-mailВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Apple Mail
Как установить Apple Mail в Claude Code?
Выполните в терминале команду claude mcp add mcp-apple-mail -- npx -y @mgcrea/mcp-apple-mail. Для включения записи и фильтрации аккаунтов используйте вариант с переменными: `claude mcp add --env APPLE_MAIL_ALLOW_WRITES=<APPLE_MAIL_ALLOW_WRITES> --env APPLE_MAIL_ACCOUNTS=<APPLE_MAIL_ACCOUNTS> --env APPLE_MAIL_ALLOW_FILE_SEND=<APPLE_MAIL_ALLOW_FILE_SEND> --transport stdio mail -- npx -y @mgcrea/mcp-apple-mail`.
Зачем серверу нужен Full Disk Access?
Без Full Disk Access агент не сможет читать локальную базу Envelope Index и файлы .emlx. В таком режиме доступны только списки ящиков и подсчёт писем через AppleScript, а поиск и чтение текстов блокируются операционной системой.
Разрешена ли отправка писем по умолчанию?
Нет, инструменты для изменения почты отключены по умолчанию через переменную APPLE_MAIL_ALLOW_WRITES="0". Пока вы явно не измените этот параметр, сервер работает исключительно в режиме чтения.
Похожие MCP-серверы
Все MCP-серверы по теме «Заметки, задачи и проекты» →Сначала — Apple Mail от других авторов.
