Apple Mail MCP (imdinu)
MCP-сервер для Apple Mail на macOS: 8 инструментов чтения и поиск по телу писем через индекс FTS5 на больших ящиках
- 74 ★ репозитория
- Последний коммит
- GPL-3.0
Широкий доступ
Почему такой уровень
- Сервер читает все письма и вложения в Apple Mail и передает их агенту, в письмах бывают персональные и финансовые данные
- Для индекса нужен Full Disk Access для приложения, которое запускает сервер
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/apple-mail-mcp-imdinuОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Сервер читает все письма и вложения в Apple Mail и передает их агенту, в письмах бывают персональные и финансовые данные
- Для индекса нужен Full Disk Access для приложения, которое запускает сервер
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту читать и искать почту в приложении Apple Mail. В наборе восемь инструментов: `list_accounts` и `list_mailboxes` показывают учетные записи и ящики, `get_emails` отдает письма по фильтрам (все, непрочитанные, помеченные, за сегодня, за семь дней), `get_email` возвращает одно письмо целиком с вложениями. `search` ищет по теме, отправителю, телу и вложениям с диапазоном дат и подсветкой, `get_email_links` вынимает ссылки, `get_email_attachment` извлекает содержимое вложения. Полнотекстовый поиск по телу работает через собственный индекс SQLite FTS5, который покрывает весь ящик. Автор сравнил сервер с шестью другими Apple Mail MCP на ящике около 73 тысяч писем: серверы на AppleScript упираются в таймауты, а один из конкурентов сканирует только 5000 последних писем. Одно письмо читается напрямую из файлов `.emlx` примерно за 3 мс, а списки аккаунтов и писем берутся из базы Envelope Index, JXA остается запасным путем. Те же команды доступны в терминале без MCP: `apple-mail-mcp search`, `read`, `emails`, `accounts`, `mailboxes`, `extract`. Команда `apple-mail-mcp integrate claude` готовит файл скилла для Claude Code. Настройки лежат в `~/.apple-mail-mcp/config.toml` или в переменных `APPLE_MAIL_*`.
Для кого. Пользователям Mac с большой почтой в Apple Mail, которые хотят искать письма, вложения и ссылки через Claude Code или Claude Desktop.
Подходит, если
- В ящике десятки тысяч писем, и нужно найти счет по словам из текста письма, когда тема ничего не говорит
- Агенту надо вытащить вложение из письма от поставщика и разобрать его содержимое
- Нужна сводка непрочитанных и помеченных писем за последние семь дней по рабочей учетной записи
- Из переписки надо собрать все ссылки на документы и сервисы
Не подходит, если
- Нужно отправлять, удалять или перемещать письма: набор инструментов только читает
- Почта хранится в веб-интерфейсе или другом клиенте: сервер читает только приложение Apple Mail на macOS
- Нужен доступ с Windows или Linux: проект рассчитан на macOS
Пример запроса к агенту
Найди во всей моей почте Apple Mail письма со счетом за октябрь, где слово «договор» есть в тексте, и покажи вложения.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
APPLE_MAIL_DEFAULT_ACCOUNT- Учетная запись Apple Mail по умолчанию.
Ограничения
Работает только с Apple Mail на macOS. Для свежего индекса приложению, которое запускает сервер (Claude Code, Claude Desktop или Terminal), нужен Full Disk Access в настройках конфиденциальности. Индекс строится командой `apple-mail-mcp index --verbose` и рекомендован автором для больших ящиков. Инструмент `get_attachment` устарел, вместо него `get_email_attachment`.
Сервер читает ваши письма целиком, включая вложения, и передает их агенту. Плагин и пакет mcpb запускают опубликованный в PyPI пакет через лаунчер: uvx, затем pipx, затем приватное окружение. Лицензия GPL-3.0 или новее.
Как отключить. В Claude Code выполните `claude plugin uninstall apple-mail@imdinu`, в Claude Desktop удалите расширение, в остальных клиентах уберите блок mail из конфигурации. Пакет снимается командой `pipx uninstall apple-mail-mcp`, индекс и настройки лежат в `~/.apple-mail-mcp/`. Full Disk Access отзовите в настройках macOS.
Частые вопросы
Как поставить Apple Mail MCP в Claude Code?
Выполните `claude plugin marketplace add imdinu/apple-mail-mcp`, затем `claude plugin install apple-mail@imdinu`. Дайте Claude Code доступ Full Disk Access, чтобы индекс обновлялся.
Как поставить в Claude Desktop?
Скачайте файл `apple-mail-mcp-<версия>.mcpb` со страницы последнего релиза и откройте его двойным щелчком. Расширение само запускает сервер с флагом `--watch`.
Умеет ли сервер отправлять письма?
Нет, все восемь инструментов только читают и ищут. Отправка, удаление и перемещение писем в наборе не предусмотрены.
Чем он отличается от других Apple Mail MCP?
Поиск по телу идет через индекс FTS5, который покрывает весь ящик. Конкурентный сервер с таким поиском просматривает только 5000 последних писем, а AppleScript-серверы на больших ящиках упираются в таймауты.
Можно ли пользоваться без MCP?
Да, те же команды доступны в терминале: `apple-mail-mcp search "invoice" --after 2026-01-01 --limit 10`. Все команды печатают JSON.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер к почте на Mac: агент читает, ищет, пишет, сортирует письма и разбирает ящик, есть режим только для чтения
MCP-сервер для Apple Mail на macOS: поиск, чтение, черновики, правила и вложения, опасные шаги с подтверждением.
MCP-сервер для Apple Mail на macOS: чтение, поиск, отправка и разбор почты через AppleScript или IMAP и SMTP.
MCP почта на 52 инструмента: агент читает, ищет, отправляет и сортирует письма в нескольких ящиках по IMAP и SMTP, планирует отправку
Email SMTP/IMAP MCP — почта в нескольких аккаунтах
Email SMTP/IMAP MCP
MCP почта на шесть инструментов: один локальный сервер ищет, читает, отправляет, пересылает и раскладывает письма в любом числе аккаунтов IMAP и SMTP
imap-mcp-server — почта по IMAP и SMTP для агента
imap-mcp-server
MCP-сервер дает агенту искать, читать, отправлять и чистить письма в нескольких ящиках, а пароли хранит под шифрованием AES-256
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Apple Mail MCP (imdinu) (эта карточка) | нет | не нужна | 74 | |
| Apple Mail MCP Server | нет | не нужна | 256 | другой сервер для Apple Mail, этот добавляет индекс FTS5 для поиска по телу всего ящика и чтение вложений |
| apple-mail-mcp | нет | не нужна | 111 | тоже работает с Apple Mail, этот делает ставку на полное покрытие поиска по телу и скорость на больших ящиках |
Коротко о README
Описание подает сервер как единственный Apple Mail MCP с полнотекстовым поиском по всему ящику и приводит замеры на 73 тысячах писем. Дальше идут установка плагином, пакетом mcpb и через pipx, построение индекса, настройка, таблица инструментов и CLI.