imap-mcp-server — почта по IMAP и SMTP для агента
imap-mcp-server
MCP-сервер дает агенту искать, читать, отправлять и чистить письма в нескольких ящиках, а пароли хранит под шифрованием AES-256
- 129 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент читает всю почту ящика, отправляет письма от вашего имени и может удалять сообщения массово
- Логины и пароли ящиков лежат в файле на диске, ключ шифрования рядом: файлы нужно беречь
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/imap-mcp-serverОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент читает всю почту ящика, отправляет письма от вашего имени и может удалять сообщения массово
- Логины и пароли ящиков лежат в файле на диске, ключ шифрования рядом: файлы нужно беречь
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
imap-mcp-server подключает агента к почтовым ящикам по IMAP и SMTP. Агент ищет письма, читает их, переносит между папками, ставит флаги и метки, скачивает вложения, пишет черновики, отправляет, отвечает и пересылает. Есть инструменты для списка папок, счетчика непрочитанных, поиска цепочки писем по Message-ID и статистики по доменам. Учетные записи хранятся в файле `~/.imap-mcp/accounts.json`, пароли шифруются AES-256-CBC, а ключ лежит отдельно в `~/.imap-mcp/.key`. Файлы доступны только владельцу. Для добавления ящика есть веб-мастер, который слушает только `127.0.0.1` и знает настройки более чем 15 провайдеров, включая Gmail, Outlook и Yahoo. Настройки SMTP подбираются по IMAP-провайдеру. Сервер держит пул соединений и работает с несколькими ящиками сразу. Есть удаление по поиску, по домену и очистка спама: эти инструменты опасны, поэтому их можно скрыть. Переменная `IMAP_MCP_READ_ONLY` оставляет только поиск, чтение и подсчеты.
Для кого. Тем, кто хочет разбирать, искать и отправлять почту через агента в Claude Desktop, Claude Code или Cursor, включая несколько ящиков у разных провайдеров.
Подходит, если
- Нужно найти в рабочем ящике все письма от поставщика за квартал и свести их в список
- Почту надо разобрать: перенести рассылки в папку и отметить прочитанными
- Агент готовит черновик ответа, и вы сами решаете, отправлять ли его
- Требуется очистить ящик от спама и писем с одного домена после проверки списка
- Ящиков несколько, и нужен один помощник для всех, с общим поиском
Не подходит, если
- Достаточно разовой выгрузки писем: для этого проще экспорт из почтового клиента, чем постоянный доступ агента
- Агенту нельзя доверять отправку и удаление без проверки: включите `IMAP_MCP_READ_ONLY` или не ставьте сервер
- Нужен вход по OAuth для Gmail или Outlook: сервер работает с логином и паролем, часто с паролем приложения
Пример запроса к агенту
Найди письма от бухгалтерии за октябрь, составь список с темами и датами и подготовь черновик ответа на последнее, не отправляя его.MCP
- Транспорт
- stdio
- Авторизация
- ключ необязателен
Переменные окружения
IMAP_MCP_READ_ONLY- Значение 1 оставляет только инструменты чтения.
IMAP_MCP_WIZARD_TOKENсекрет- Токен веб-мастера при запуске не на loopback, не короче 16 символов.
Ограничения
Нужен Node 22.12 или новее: версии 18 и 20 устарели, зависимости пакета их больше не поддерживают. Доступ идет по логину и паролю, а у многих провайдеров для этого требуется пароль приложения.
По умолчанию агент видит все инструменты, в том числе отправку и массовое удаление. Режим только для чтения включается переменной `IMAP_MCP_READ_ONLY`, а выбор нужных инструментов задается отдельной переменной. Если сервер IMAP не поддерживает поиск, включается медленный запасной путь: он скачивает конверты всей папки, а поиск по тексту отказывает при более чем 2000 кандидатах.
Инструменты удаления по поиску, по домену и очистки спама на запасном пути возвращают ошибку: письма нужно найти через `imap_search_emails` и удалить по UID.
Как отключить. Удалите сервер из конфигурации MCP-клиента. Сохраненные учетные записи удалите вручную: папка `~/.imap-mcp` хранит шифрованный файл `accounts.json` и ключ `.key`.
Частые вопросы
Как поставить сервер?
Самый простой путь — `npx -y imap-mcp-server`, нужен Node 22.12 или новее. Есть и скрипты `install.sh` и `install.ps1`, но их устанавливать вслепую не стоит: прочитайте перед запуском.
Где хранятся пароли?
В файле `~/.imap-mcp/accounts.json` в шифрованном виде (AES-256-CBC), ключ лежит отдельно в `~/.imap-mcp/.key`. Права на папку и файлы выставлены только для владельца.
Можно ли выдать агенту только чтение?
Да. Переменная `IMAP_MCP_READ_ONLY` со значением `1` оставляет поиск, чтение, список папок, счетчики непрочитанных и анализ спама. Отправка, перенос и удаление не регистрируются.
Как добавить ящик?
Запустите веб-мастер командой `npx -p imap-mcp-server imap-setup`: он откроет браузер с готовыми настройками провайдеров. Или попросите ассистента вызвать `imap_add_account`, хотя пароль тогда пройдет через чат.
Можно ли хранить пароли вне файла?
Да, логин и пароль уже добавленного ящика переопределяются переменными окружения вида `IMAP_MCP_ACCOUNT_<ИМЯ>_IMAP_PASSWORD`. Значение попадает в зашифрованный кэш в памяти и удаляется из `process.env`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер почты по IMAP и SMTP: агент ищет, читает, сортирует и отправляет письма из нескольких ящиков
MCP почта на 52 инструмента: агент читает, ищет, отправляет и сортирует письма в нескольких ящиках по IMAP и SMTP, планирует отправку
Email SMTP/IMAP MCP — почта в нескольких аккаунтах
Email SMTP/IMAP MCP
MCP почта на шесть инструментов: один локальный сервер ищет, читает, отправляет, пересылает и раскладывает письма в любом числе аккаунтов IMAP и SMTP
MCP-сервер к почте на Mac: агент читает, ищет, пишет, сортирует письма и разбирает ящик, есть режим только для чтения
MCP-сервер для Apple Mail на macOS: чтение, поиск, отправка и разбор почты через AppleScript или IMAP и SMTP.
MCP-сервер чтения почты Mail.ru
Mail.ru MCP
Небольшой read-only MCP-сервер для почты Mail.ru: список писем, чтение, поиск и папки без возможности отправки или удаления
Коротко о README
README перечисляет возможности, установку через npx и скрипты, настройку учетных записей с веб-мастером и переопределением учетных данных через окружение. Затем идут конфигурации для клиентов, ограничение набора инструментов, описание каждого инструмента с параметрами и раздел безопасности.