Apple Mail — MCP-сервер для Claude Code: почта на macOS
Даёт агенту доступ к Apple Mail на macOS: читать, искать, писать и отправлять письма прямо из чата.
claude mcp add --env APPLE_MAIL_MCP_SAFETY_PROFILE=<APPLE_MAIL_MCP_SAFETY_PROFILE> --env APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT=<APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT> --env APPLE_MAIL_MCP_VISIBLE_DRAFTS=<APPLE_MAIL_MCP_VISIBLE_DRAFTS> --transport stdio applemail-mcp -- uvx apple-mcp-mailЧто делает Apple Mail
Сервер поднимается локально на вашем Mac и отдаёт клиенту инструменты для работы с почтой: поиск по отправителю или теме, чтение переписки, черновики и отправка. Есть отдельные средства для тредов — mail_get_thread, mail_reply_latest_in_thread, mail_archive_thread. Если адрес получателя неизвестен, контакты стоит уточнить заранее: отправка вслепую по догадке — плохая идея.
Нужны macOS и Python 3.11+. Установка идёт через uvx, поэтому сначала поставьте uv. Профиль безопасности задаётся переменной APPLE_MAIL_MCP_SAFETY_PROFILE: для uvx и pip по умолчанию это safe_manage, а в бандлах для Claude Desktop — full_access. Пустое или неверное значение переключает сервер в safe_readonly, и часть инструментов перестанет работать. Вложения выключены, пока не задан APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT с отдельной папкой.
Данные не остаются только на вашем Mac: клиент может передать их провайдеру модели, а Apple-приложения синхронизируются через iCloud или другую учётную запись. Транспорт по умолчанию — stdio. Если включаете Streamable HTTP, сервер принимает только 127.0.0.1, ::1 или localhost: удалённой аутентификации нет, и наружу его выставлять нельзя. Разрешения в macOS придётся подтвердить самому — в системном запросе или в настройках.
Какие задачи решает
- найти письмо по отправителю или обрывку темы
- прочитать всю переписку в треде и ответить на последнее сообщение
- отправить письмо с нужного адреса через
from_account - убрать разобранный тред в архив
- проверить доступ к Mail без чтения самих писем
Примеры запросов агенту
- Найди в Apple Mail письма от бухгалтерии за прошлую неделю
- Прочитай тред по теме «договор» и ответь на последнее письмо
- Отправь черновик с адреса
[email protected]
Как установить Apple Mail
Командой платформы
claude mcp add --env APPLE_MAIL_MCP_SAFETY_PROFILE=<APPLE_MAIL_MCP_SAFETY_PROFILE> --env APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT=<APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT> --env APPLE_MAIL_MCP_VISIBLE_DRAFTS=<APPLE_MAIL_MCP_VISIBLE_DRAFTS> --transport stdio applemail-mcp -- uvx apple-mcp-mailВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from apple-mcp-mail <команда>
Командой платформы
codex mcp add applemail-mcp --env APPLE_MAIL_MCP_SAFETY_PROFILE=<APPLE_MAIL_MCP_SAFETY_PROFILE> --env APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT=<APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT> --env APPLE_MAIL_MCP_VISIBLE_DRAFTS=<APPLE_MAIL_MCP_VISIBLE_DRAFTS> -- uvx apple-mcp-mailВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from apple-mcp-mail <команда>
Файл настроек
{
"mcpServers": {
"applemail-mcp": {
"command": "uvx",
"args": [
"apple-mcp-mail"
],
"env": {
"APPLE_MAIL_MCP_SAFETY_PROFILE": "<APPLE_MAIL_MCP_SAFETY_PROFILE>",
"APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT": "<APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT>",
"APPLE_MAIL_MCP_VISIBLE_DRAFTS": "<APPLE_MAIL_MCP_VISIBLE_DRAFTS>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from apple-mcp-mail <команда>
Файл настроек
{
"servers": {
"applemail-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"apple-mcp-mail"
],
"env": {
"APPLE_MAIL_MCP_SAFETY_PROFILE": "<APPLE_MAIL_MCP_SAFETY_PROFILE>",
"APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT": "<APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT>",
"APPLE_MAIL_MCP_VISIBLE_DRAFTS": "<APPLE_MAIL_MCP_VISIBLE_DRAFTS>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from apple-mcp-mail <команда>
Командой платформы
gemini mcp add -e APPLE_MAIL_MCP_SAFETY_PROFILE=<APPLE_MAIL_MCP_SAFETY_PROFILE> -e APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT=<APPLE_MAIL_MCP_ALLOWED_ATTACHMENT_ROOT> -e APPLE_MAIL_MCP_VISIBLE_DRAFTS=<APPLE_MAIL_MCP_VISIBLE_DRAFTS> applemail-mcp uvx apple-mcp-mailВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from apple-mcp-mail <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Apple Mail
Как установить Apple Mail MCP в Claude Code?
Сначала поставьте uv, затем выполните claude mcp add apple-mcp-mail -- uvx apple-mcp-mail. После установки перезапустите клиент.
Что делает Apple Mail MCP?
Даёт агенту читать, искать, писать и отправлять письма через Apple Mail на macOS. Отдельные инструменты работают с тредами и вложениями.
Почему часть инструментов не работает?
Возможно, профиль безопасности выставлен неверно. Пустое или некорректное значение APPLE_MAIL_MCP_SAFETY_PROFILE включает safe_readonly, и запись блокируется.
