mcp-email-server
MCP-сервер почты по IMAP и SMTP: агент ищет, читает, сортирует и отправляет письма из нескольких ящиков
- 372 ★ репозитория
- Последний коммит
- BSD-3-Clause
Широкий доступ
Почему такой уровень
- Читает личные письма и вложения, пароль ящика хранится на вашей машине
- Может отправлять и пересылать письма от вашего имени, а также удалять и переносить сообщения
- Инструмент email_command выполняет произвольные команды IMAP и SMTP, если владелец включил его для ящика
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-email-serverОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Читает личные письма и вложения, пароль ящика хранится на вашей машине
- Может отправлять и пересылать письма от вашего имени, а также удалять и переносить сообщения
- Инструмент email_command выполняет произвольные команды IMAP и SMTP, если владелец включил его для ящика
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
mcp-email-server подключает ИИ-агента к почтовым ящикам по протоколам IMAP и SMTP. Агент выбирает ящик, ищет письма по теме, отправителю, дате или тексту в теле и получает список с идентификаторами. Содержимое тянется отдельным вызовом, поэтому большие тела писем не попадают в контекст, пока они не нужны. Кроме чтения сервер умеет отправлять и пересылать письма, сохранять черновики и раскладывать почту по папкам и меткам. Вложения можно скачать или прочитать как содержимое. Каждое право включается для ящика отдельно, от черновиков до удаления и отправки. Настройки аккаунтов хранятся локально. Команда `uvx mcp-email-server@latest ui` открывает панель управления на адресе 127.0.0.1, а пароли лежат в таблице базы или в системном хранилище ключей, в зависимости от системы.
Для кого. Для тех, кто разбирает входящие или готовит ответы через Claude Code, Cursor, Codex или Claude Desktop для нескольких почтовых ящиков сразу.
Подходит, если
- Агент должен найти в ящике счета от конкретного отправителя за квартал и пересказать их по одному
- Нужно держать рабочий и личный ящики в одном клиенте и ограничить, из какого из них агент вправе отправлять письма
- Вы хотите, чтобы агент готовил ответы черновиками, а отправляли вы сами: право отправки в этом случае не включается
- Почту надо разложить по папкам и меткам по правилам, которые вы описали агенту словами
- Сервер должен работать в контейнере: с версии 1.6.2 публикуются образы Linux для amd64 и arm64
Не подходит, если
- Ящик находится у сервиса, который не открывает доступ по IMAP и SMTP: сервер работает только по этим протоколам
- Нужна массовая рассылка по базе адресов: сервер дает агенту работать с вашими ящиками, инструментов для рассылок в нем нет
- Агент не должен видеть содержимое писем вообще: даже при ограниченных правах он читает почту ящика
- Вам нужен готовый почтовый клиент с интерфейсом для людей: это программа для агента
Пример запроса к агенту
Покажи список подключенных почтовых аккаунтов, затем найди во входящих письма с вложениями от бухгалтерии за последние две неделиMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
MCP_EMAIL_SERVER_CONFIG_PATH- Путь к файлу настроек старого режима, если нужен не стандартный
Ограничения
- С версии 1.0.0 настройки хранятся по-новому. Обновление пакета не переносит прежние настройки: они работают в режиме legacy, пока вы сами не выполните перенос.
- Тело письма по умолчанию обрезается на 20 000 знаков.
- Расширенный инструмент email_command выключен по умолчанию. Его включает владелец в настройках ящика, через MCP этого не сделать, и он требует широких прав, включая удаление.
- Работа идет только через IMAP и SMTP. Если провайдер требует особый способ входа, понадобится пароль приложения.
- Панель управления запускается на переднем плане и привязана к 127.0.0.1, удаленного режима у нее нет.
Как отключить. Уберите запись mcp-email-server из конфигурации клиента и перезапустите его. Данные аккаунтов остаются в локальном хранилище. Прежний файл настроек лежит в ~/.config/mcp-email-server/config.toml, удалите его и записи ключей, чтобы стереть пароли.
Частые вопросы
Как подключить почтовый ящик к mcp-email-server?
Запустите `uvx mcp-email-server@latest ui` и оставьте команду работающей. В панели введите адрес и пароль: настройки подключения подставятся по домену, и их можно поправить. Исходящая почта настраивается необязательно. После сохранения перезапустите MCP-клиент.
Как добавить mcp-email-server в Claude Code или Claude Desktop?
Добавьте сервер с командой uvx и аргументами mcp-email-server@latest и stdio в конфигурацию клиента. Для Claude Desktop в репозитории лежит пример dev/claude_desktop_config.json. После правки перезапустите клиент и попросите его перечислить аккаунты.
Что делают права draft, organize, delete, send и append?
Право draft разрешает save_draft. Organize открывает пометки прочитанным, флаги, метки, перенос, архив и создание папки. Delete включает delete_emails, send включает send_email и forward_email, append разрешает save_to_mailbox. Права назначаются для каждого аккаунта отдельно.
Можно ли запустить сервер в Docker?
Да. Начиная с версии 1.6.2 публикуются образы Linux для amd64 и arm64 в ghcr.io/wh1isper/mcp-email-server. Инструкция по контейнеру есть в документации в разделе Getting Started.
Как перенести старые настройки с версии 0.16.0 и ранее?
Переносить не обязательно: прежние настройки продолжают работать в режиме legacy. Для переноса выполните `config init`, затем `config import-legacy` для просмотра плана и `config import-legacy --apply`, подтвердив ввод слова IMPORT. Исходный TOML-файл при этом остается нетронутым.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP почта на 52 инструмента: агент читает, ищет, отправляет и сортирует письма в нескольких ящиках по IMAP и SMTP, планирует отправку
Email SMTP/IMAP MCP — почта в нескольких аккаунтах
Email SMTP/IMAP MCP
MCP почта на шесть инструментов: один локальный сервер ищет, читает, отправляет, пересылает и раскладывает письма в любом числе аккаунтов IMAP и SMTP
MCP-сервер почты Mail.ru
mailru-mcp
MCP-сервер для почты Mail.ru: чтение, поиск, сортировка по папкам и архивация с обходом особенностей Mail.ru по IMAP
Email MCP: почта Яндекса, Mail.ru и других провайдеров
Email MCP Server
HTTP/SSE-обертка над IMAP MCP-сервером для удаленного доступа к почте из Claude Web: чтение, поиск, отправка и до 15 провайдеров, включая Яндекс и Mail.ru
Yandex Mail MCP
Yandex Mail MCP Server
MCP-сервер Яндекс Почты по IMAP и SMTP: поиск и чтение писем, вложения, отправка, перенос и удаление
MCP-сервер чтения почты Mail.ru
Mail.ru MCP
Небольшой read-only MCP-сервер для почты Mail.ru: список писем, чтение, поиск и папки без возможности отправки или удаления
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| mcp-email-server (эта запись) | нет | не нужна | 372 | |
| email-mcp — MCP-сервер для почты по IMAP и SMTP | нет | ключ необязателен | 142 | тоже почта по IMAP и SMTP, но с другим набором инструментов и своей моделью прав |
| Yandex Mail MCP | нет | не нужна | 8 | рассчитан на Яндекс Почту, а этот сервер работает с любым ящиком по IMAP и SMTP |
Коротко о README
Быстрый старт занимает три шага: настроить ящик в локальной панели, прописать сервер в клиенте и проверить подключение. Права, контейнеры и миграцию подробно разбирает отдельная документация проекта.