Apple Mail MCP Server

MCP-сервер к почте на Mac: агент читает, ищет, пишет, сортирует письма и разбирает ящик, есть режим только для чтения

  • 256 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Широкий доступ

Почему такой уровень

  • Сервер читает все письма во всех учетных записях Mail, включая личные
  • Он может отправлять, пересылать и удалять письма, если не включен `--read-only`
  • Сохранение вложений пишет файлы на диск с правами вашей учетной записи
Все причины и проверки

patrickfreyer/apple-mail-mcp

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/apple-mail-mcp-server

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Сервер читает все письма во всех учетных записях Mail, включая личные
  • Он может отправлять, пересылать и удалять письма, если не включен `--read-only`
  • Сохранение вложений пишет файлы на диск с правами вашей учетной записи

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Apple Mail MCP открывает ИИ-ассистенту почтовое приложение Apple Mail на macOS. Сервер на FastMCP дает 23 инструмента. Чтение и поиск: сводка по ящику, список писем с фильтрами по учетной записи и статусу, поиск по теме, отправителю, тексту, датам, вложениям и цветным меткам, цепочки переписки. Организация: папки, перенос и архивирование писем, пометки прочитано и важное, корзина. Письма агент составляет, отправляет, пересылает и отвечает на них, ведет черновики, сохраняет вложения на диск. Умный разбор ящика находит отправленные письма без ответа, письма, на которые, вероятно, нужно ответить, и самых частых отправителей, есть и статистика. Установка идет через плагин Claude Code вместе со слэш-командой `/email-management` и скиллом по работе с почтой, через `uvx`, `pip`, пакет `.mcpb` для Claude Desktop или вручную.

Для кого. Пользователям Mac с настроенным Apple Mail, которые хотят разобрать входящие, найти нужные письма и отвечать через агента.

Подходит, если

  • Во входящих сотни писем, и надо понять, на какие нужно ответить, а какие давно ждут ответа
  • Нужно найти переписку по теме с вложением за определенные даты в нескольких учетных записях
  • Хочется разложить рассылки по папкам и архивировать старое с пробным прогоном
  • Агенту нужно написать черновик ответа, который вы проверите и отправите сами

Не подходит, если

  • Работаете не на macOS или с другим почтовым клиентом: сервер управляет только Apple Mail
  • Агенту нельзя доверять отправку писем: запускайте с `--read-only` или выбирайте другой инструмент
  • Нужна массовая рассылка: сервер ограничивает пакетные действия небольшими числами

Пример запроса к агенту

Покажи, на какие письма во входящих мне, скорее всего, нужно ответить, и сделай черновик ответа на самое старое

MCP

Транспорт
stdio
Авторизация
не нужна

Переменные окружения

USER_EMAIL_PREFERENCES
Короткое описание ваших привычек работы с почтой для ассистента

Ограничения

Нужны macOS с настроенным Apple Mail и Python 3.10 или новее. При первом запуске macOS спросит разрешение на управление Mail. Сервер видит все учетные записи в Mail и может отправлять письма, пока не включен `--read-only`. По умолчанию пакетные действия ограничены: смена статуса 10 писем, корзина 5, перенос 1 письма, лимиты меняют параметрами. Запись на диск и вложения идут с черным списком опасных мест (оболочки, `~/.ssh`, автозапуск), но в остальных папках сервер пишет с правами вашей учетной записи.

Как отключить. Командой `claude plugin uninstall apple-mail` уберите плагин или удалите сервер из конфигурации клиента, например `claude mcp remove apple-mail`. Для файла `.mcpb` удалите расширение в настройках Claude Desktop.

Частые вопросы

Как поставить сервер в Claude Code?

Проще всего плагин: `claude plugin marketplace add patrickfreyer/apple-mail-mcp`, затем `claude plugin install apple-mail@apple-mail-mcp`. Для одного MCP-сервера подойдет `claude mcp add apple-mail -- uvx mcp-apple-mail`.

Как запретить отправку писем?

Запустите сервер с `--read-only`: `compose_email`, `reply_to_email` и `manage_drafts` откажутся отправлять, а `forward_email` исчезнет. Черновики и режим открытия окна продолжат работать.

Какие инструменты есть для вложений?

`list_email_attachments` показывает имена и размеры, `save_email_attachment` сохраняет файл на диск. Запись в опасные места, например в `~/.ssh` или автозапуск, сервер отклоняет.

Работает ли сервер с Claude Desktop?

Да, есть пакет `.mcpb`: скачайте его из релизов и установите через Settings, Developer, MCP Servers. Можно и записать `uvx mcp-apple-mail` в `claude_desktop_config.json`.

Можно ли подсказать ассистенту мои привычки?

Да, переменная `USER_EMAIL_PREFERENCES` принимает короткое описание вроде «по умолчанию рабочая учетная запись, не больше 50 писем, папки Архив и Проекты».

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

MCP-сервер для Apple Mail на macOS: поиск, чтение, черновики, правила и вложения, опасные шаги с подтверждением.

MCP-серверШирокий доступ105Звезды репозитория

MCP-сервер для Apple Mail на macOS: чтение, поиск, отправка и разбор почты через AppleScript или IMAP и SMTP.

MCP-серверШирокий доступ111Звезды репозитория

MCP-сервер для Apple Mail на macOS: 8 инструментов чтения и поиск по телу писем через индекс FTS5 на больших ящиках

MCP-серверШирокий доступ74Звезды репозитория

MCP почта на 52 инструмента: агент читает, ищет, отправляет и сортирует письма в нескольких ящиках по IMAP и SMTP, планирует отправку

MCP-серверШирокий доступ158Звезды репозитория

MCP-сервер дает агенту искать, читать, отправлять и чистить письма в нескольких ящиках, а пароли хранит под шифрованием AES-256

MCP-серверШирокий доступ129Звезды репозитория

MCP-сервер почты по IMAP и SMTP: агент ищет, читает, сортирует и отправляет письма из нескольких ящиков

MCP-серверШирокий доступ393Звезды репозитория

Коротко о README

Описание проекта начинается с установки: плагин Claude Code, затем остальные способы. Дальше идет таблица из 23 инструментов по группам (чтение и поиск, организация, составление писем, вложения, умный ящик, аналитика), настройка режима чтения, пользовательских предпочтений, пределов пакетных действий и правил доступа к файлам.

Бейдж для README

Сообщить о проблеме