Apple Mail MCP — MCP-сервер для Claude Code: поиск по почте
MCP-сервер для чтения и поиска писем Apple Mail. Ищет по телу письма по всей почтовой базе, а не только по последним сообщениям.
claude mcp add apple-mail-mcp -- uvx apple-mail-mcpЧто делает Apple Mail MCP
Сервер даёт агенту 8 инструментов: список аккаунтов и ящиков, выборку писем по фильтру, чтение одного письма с вложениями, поиск по теме, отправителю, телу и вложениям, извлечение ссылок и содержимого файлов. Поиск по телу работает через индекс FTS5, который покрывает весь ящик, поэтому старые письма тоже находятся.
Ставится как обычный MCP-сервер: pipx install apple-mail-mcp и запись в конфиг клиента с командой apple-mail-mcp. Для Claude есть плагин из маркетплейса, он запускает тот же пакет с PyPI через тонкий лаунчер. После установки стоит собрать индекс командой apple-mail-mcp index --verbose.
Нужен macOS и Python 3.11+. Терминалу или приложению, которое запускает сервер, понадобится Full Disk Access — без него индекс не обновится. Все инструменты доступны и как CLI-команды, вывод в JSON.
Какие задачи решает
- найти письмо по фразе из тела, а не только по теме
- вытащить вложение из конкретного письма
- собрать список непрочитанных за неделю
- достать все ссылки из письма
- переключиться между несколькими почтовыми аккаунтами
Примеры запросов агенту
- Найди письма со словом «договор» в теле за последний месяц
- Покажи непрочитанные письма из ящика Work
- Извлеки вложение invoice.pdf из письма 12345
Как установить Apple Mail MCP
Командой платформы
claude mcp add apple-mail-mcp -- uvx apple-mail-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from apple-mail-mcp <команда>
Командой платформы
codex mcp add apple-mail-mcp -- uvx apple-mail-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from apple-mail-mcp <команда>
Файл настроек
{
"mcpServers": {
"apple-mail-mcp": {
"command": "uvx",
"args": [
"apple-mail-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from apple-mail-mcp <команда>
Файл настроек
{
"servers": {
"apple-mail-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"apple-mail-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from apple-mail-mcp <команда>
Командой платформы
gemini mcp add apple-mail-mcp uvx apple-mail-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from apple-mail-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Apple Mail MCP
Как установить Apple Mail MCP в Claude Code?
Через маркетплейс плагинов: claude plugin marketplace add imdinu/apple-mail-mcp, затем claude plugin install apple-mail@imdinu. Либо как MCP-сервер командой claude mcp add apple-mail-mcp -- uvx apple-mail-mcp.
Что делает Apple Mail MCP?
Даёт агенту доступ к почте Apple Mail: список аккаунтов и ящиков, чтение писем, поиск по теме, отправителю, телу и вложениям, извлечение ссылок и файлов. Поиск по телу идёт по индексу FTS5 по всему ящику.
Что нужно для работы сервера?
macOS, Python 3.11+ и Full Disk Access для приложения, которое запускает сервер. После установки индекс собирается командой apple-mail-mcp index --verbose.
