imap-mcp-server

imap-mcp-server — MCP-сервер сообщества (автор — nikolausm). Почта по IMAP и SMTP: поиск, чтение, сортировка, отправка и пересылка. Ставится через npx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
nikolausm
Лицензия
MIT
Транспорт
stdio
Авторизация
other
ОС
Не указана
Языки
typescript

Уровень риска: high

Отправляет, пересылает и удаляет письма (в том числе массово), сохраняет вложения на диск, хранит зашифрованные пароли почты. IMAP_MCP_READ_ONLY=true оставляет только чтение.

Настройка клиентов

claude-code
{
    "code": "claude mcp add imap -- npx -y imap-mcp-server",
    "lang": "bash",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

IMAP MCP Server — MCP-сервер для работы с почтой по IMAP и SMTP: ассистент ищет, читает, сортирует, удаляет и отправляет письма в одном или нескольких ящиках. Учётные данные хранятся в зашифрованном виде (AES-256), соединения переиспользуются через пул. Для более чем 15 почтовых сервисов настройки заданы заранее: Gmail, Outlook, Yahoo, iCloud, GMX, WEB.DE, IONOS, ProtonMail (через Bridge), Fastmail, Zoho, AOL, mailbox.org, Posteo и собственные IMAP-серверы; SMTP настраивается автоматически по IMAP-провайдеру.

Инструменты:

  • Аккаунты — добавление, изменение, проверка, список и удаление аккаунтов, подключение и отключение.
  • Письма — поиск, получение письма и последних писем, поиск по Message-ID и сообщений цепочки, отметка прочитанным, флаги и ключевые слова, перемещение, удаление, массовое удаление по списку и по поиску, скачивание вложений.
  • Отправка — отправка, ответ и пересылка через SMTP, сохранение черновика.
  • Папки — список папок, статус, создание папки, число непрочитанных.
  • Спам — проверка на спам, статистика по доменам, список спам-доменов, удаление спама и писем с определённого домена.

Если настроен один аккаунт, указывать его в вызовах не нужно; при нескольких аккаунтах выбор делается по accountId или accountName.

Ограничение доступа. Переменная IMAP_MCP_READ_ONLY=true оставляет только безопасные инструменты чтения: поиск, чтение, список папок, непрочитанные, анализ спама — без отправки, удаления и перемещения. IMAP_MCP_ENABLED_TOOLS задаёт явный список разрешённых инструментов.

Кому подойдёт

  • Пользователям с несколькими почтовыми ящиками, которые хотят разбирать почту через ассистента.
  • Тем, кто борется со спамом и завалами писем: массовая очистка по домену или поиску.
  • Пользователям сервисов без собственного MCP — подойдёт любой IMAP-сервер.

Похожие серверы — в категории коммуникации.

Установка

Нужен Node.js 22.12 или новее. Сервер запускается без установки: npx -y imap-mcp-server. Аккаунты хранятся в зашифрованном файле ~/.imap-mcp/accounts.json, общем для всех режимов запуска. Добавить их можно веб-мастером настройки (npx -p imap-mcp-server imap-setup) или прямо из ассистента инструментом imap_add_account. Логин и пароль можно подставлять через переменные окружения вида IMAP_MCP_ACCOUNT_ИМЯ_IMAP_PASSWORD, не храня их в файле.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

claude mcp add imap -- npx -y imap-mcp-server

Конфиг Claude Desktop лежит в ~/Library/Application Support/Claude/claude_desktop_config.json на macOS и %APPDATA%\Claude\claude_desktop_config.json в Windows. Вариант «только чтение» подходит для того же файла.

Проверка

Спросите: «Сколько у меня непрочитанных писем во входящих?» — сработает imap_get_unread_count.

Примеры задач

Найди письма от бухгалтерии за последний месяц с вложениями и скачай счета.
Покажи статистику спама по доменам и удали все письма с самого частого спам-домена.

Риски

  • Отправка от вашего имени. Сервер отправляет, отвечает и пересылает письма — проверяйте адресатов и текст перед отправкой.
  • Необратимое удаление. Массовое удаление по поиску или домену может стереть нужные письма; для знакомства включите IMAP_MCP_READ_ONLY=true.
  • Учётные данные. Пароли зашифрованы, ключ лежит отдельно в ~/.imap-mcp/.key с правами только для владельца; не публикуйте ни ключ, ни файл аккаунтов.
  • Файлы. Вложения сохраняются в каталог загрузок; имена из писем не могут выйти за его пределы.

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

Можно ли дать ассистенту только чтение?

Да, переменная IMAP_MCP_READ_ONLY=true убирает отправку, удаление и перемещение.

Поддерживается ли Gmail?

Да, вместе с Outlook, Yahoo, iCloud и другими; для Gmail и Yahoo нужен пароль приложения.

Где хранятся пароли?

В зашифрованном ~/.imap-mcp/accounts.json; можно передавать их и через переменные окружения.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

Ruflo

Команды и рои агентов, память и хуки для Claude Code и Codex.

Риск: medium Лицензия: MIT ★ 82 058

PraisonAI

Фреймворк агентов PraisonAI с саморефлексией и поддержкой MCP.

Риск: medium Лицензия: MIT ★ 9 327

mcp-atlassian

Поиск, чтение, создание и управление контентом Confluence и Jira, включая Server и Data Center.

Риск: high Лицензия: MIT ★ 6 118

Jitsu

Управление пайплайнами данных Jitsu: направления, потоки, подключения и функции.

Риск: medium Лицензия: MIT ★ 5 132

Источники