Каталог MCP
marlinjai/email-mcp

marlinjai/email-mcp

Работайте с почтой через Gmail, Outlook и iCloud, а также любые IMAP-серверы, с помощью одного MCP сервера. 25 встроенных инструментов для поиска, отправки и массовых операций. OAuth2 и шифрование встроены. Установка через npm или npx.

README

31 инструмент

Версии

Установить сервер

@marlinjai/email-mcp

A unified MCP server for email access across Gmail, Outlook, iCloud, and generic IMAP providers.

Features

Multi-provider support -- Gmail (REST API), Outlook (Microsoft Graph), iCloud (IMAP), and generic IMAP/SMTP
OAuth2 authentication -- Browser-based OAuth flows for Gmail and Outlook, with automatic token refresh
Full email client -- Search, read, send, reply, forward, organize, and manage drafts
Batch operations -- Delete, move, or mark hundreds of emails in a single call
Lightweight search -- Compact search results by default (~20KB vs ~1.4MB) with optional full body retrieval
Encrypted credential storage -- AES-256-GCM encryption at rest with machine-derived keys
Provider-native APIs -- Uses Gmail API and Microsoft Graph where available for richer features, falls back to IMAP for universal compatibility

Installation

Install globally from npm:

npm install -g @marlinjai/email-mcp

Or run directly with npx (no install needed):

npx @marlinjai/email-mcp

Quick Start

Run the interactive setup wizard to add your email accounts:

Инструменты были проиндексированы: 04.09.2026

email_add_account

Добавить новую учетную запись IMAP или iCloud (для Gmail и Outlook требуется мастер настройки для OAuth)

Параметры

emailstringобязательный
Email address
hoststring
IMAP server hostname
namestringобязательный
Display name for the account
passwordstring
Password or app-specific password
portnumber
IMAP server port (default: 993)
providerstringобязательный
Provider type: "imap" or "icloud" (Gmail/Outlook require OAuth setup wizard)
smtpHoststring
SMTP server hostname
smtpPortnumber
SMTP server port
tlsboolean
Use TLS (default: true)

email_batch_delete

Удаляет несколько писем одновременно. Гораздо быстрее, чем удаление по одному.

Параметры

accountIdstringобязательный
emailIdsstring[]обязательный
Array of email IDs to delete
permanentboolean
Permanently delete instead of moving to trash
sourceFolderstring
Source folder (required for IMAP/iCloud when emails are not in INBOX)

email_batch_mark

Отмечает несколько писем одновременно (прочитанные/непрочитанные, помеченные звёздочкой, отмеченные флажком). Значительно быстрее, чем отметка каждого по отдельности.

Параметры

accountIdstringобязательный
emailIdsstring[]обязательный
Array of email IDs to mark
flaggedboolean
readboolean
sourceFolderstring
Source folder (required for IMAP/iCloud when emails are not in INBOX)
starredboolean

email_batch_move

Перемещает несколько писем в папку за один раз. Гораздо быстрее, чем перемещение по одному.

Параметры

accountIdstringобязательный
emailIdsstring[]обязательный
Array of email IDs to move
sourceFolderstring
Source folder (required for IMAP/iCloud when emails are not in INBOX)
targetFolderstringобязательный
Destination folder name or ID

email_batch_report_spam

Помечает несколько писем как спам/мусор за один раз. Намного быстрее, чем отдельные вызовы.

Параметры

accountIdstringобязательный
emailIdsstring[]обязательный
Array of email IDs to report as spam
sourceFolderstring
Source folder (required for IMAP/iCloud when emails are not in INBOX)

email_create_block_rule

Создаёт постоянное правило, которое перехватывает будущие письма, соответствующие шаблону, до того, как они попадут во входящие. Использует headerContains (например, по совпадению домена в поле Reply-To), чтобы блокировать семейство спам-шаблонов, у которых видимый домен в поле From постоянно меняется: прямое сопоставление по меняющемуся домену перестаёт работать уже через несколько дней. Не поддерживается на iCloud и обычном IMAP (единого стандартного механизма серверных правил для IMAP-серверов не существует). Для Outlook требуется разрешение MailboxSettings.ReadWrite: аккаунты, прошедшие аутентификацию до появления этого инструмента, должны один раз перезапустить мастер настройки, чтобы заново дать согласие.

Параметры

accountIdstringобязательный
actionenumобязательный
delete: discard on arrival. moveToJunk: on Outlook, files straight to the Junk Email folder; on Gmail, skips the inbox (archives) — Gmail's filter API cannot proactively apply the SPAM label, only its own classifier can, so this is the closest a standing rule can actually do there.
matchTypeenumобязательный
senderDomain/senderAddress: match the From address. subjectContains: match the subject. headerContains: match any header's raw content — the right choice for a stable element (e.g. a Reply-To domain) when the From domain rotates.
valuestringобязательный
The domain, address, or text to match

email_delete

Удалить письмо (по умолчанию перемещается в корзину или удаляется навсегда)

Параметры

accountIdstringобязательный
emailIdstringобязательный
permanentboolean
sourceFolderstring
Source folder (required for IMAP/iCloud when email is not in INBOX)

email_delete_block_rule

Удаляет постоянное правило блокировки, используйте это, чтобы отменить правило, которое оказалось слишком широким (например, оно заблокировало домен, который также использует настоящий корреспондент).

Параметры

accountIdstringобязательный
ruleIdstringобязательный

email_draft_create

Создать новый черновик письма

Параметры

accountIdstringобязательный
bodyobjectобязательный
subjectstringобязательный
toobject[]обязательный

email_draft_list

Показать черновики писем

Параметры

accountIdstringобязательный
limitnumber
offsetnumber

email_folder_create

Создать новую папку для писем

Параметры

accountIdstringобязательный
namestringобязательный
parentPathstring

email_forward

Переслать письмо новым получателям

Параметры

accountIdstringобязательный
bodyobject
emailIdstringобязательный
toobject[]обязательный

email_get

Получить одно письмо по ID

Параметры

accountIdstringобязательный
emailIdstringобязательный

email_get_attachment

Получает вложение письма по идентификатору, возвращает данные в кодировке base64.

Параметры

accountIdstringобязательный
attachmentIdstringобязательный
emailIdstringобязательный

email_get_categories

Вывести список всех категорий для учетной записи электронной почты (только Outlook).

Параметры

accountIdstringобязательный

email_get_labels

Вывести список всех меток для почтового аккаунта (только Gmail).

Параметры

accountIdstringобязательный

email_get_thread

Получить цепочку писем по thread ID

Параметры

accountIdstringобязательный
threadIdstringобязательный

email_label

Добавляет или удаляет метки у письма (только Gmail)

Параметры

accountIdstringобязательный
addLabelsstring[]
emailIdstringобязательный
removeLabelsstring[]

email_list_accounts

Вывести список всех настроенных email-аккаунтов и их статус подключения.

Параметры

Без параметров.

email_list_block_rules

Перечисляет постоянные правила блокировки на аккаунте, для аудита или перед его удалением.

Параметры

accountIdstringобязательный

email_list_folders

Вывести список всех папок электронной почты для аккаунта

Параметры

accountIdstringобязательный

email_mark

Пометить письмо как прочитанное/непрочитанное, помеченное звездочкой или отмеченное флажком.

Параметры

accountIdstringобязательный
emailIdstringобязательный
flaggedboolean
readboolean
sourceFolderstring
Source folder (required for IMAP/iCloud when email is not in INBOX)
starredboolean

email_move

Переместить письмо в другую папку

Параметры

accountIdstringобязательный
emailIdstringобязательный
sourceFolderstring
Source folder (required for IMAP/iCloud when email is not in INBOX)
targetFolderstringобязательный

email_remove_account

Удалить почтовый аккаунт

Параметры

accountIdstringобязательный
ID of the account to remove

email_reply

Ответить на существующее письмо

Параметры

accountIdstringобязательный
bodyobjectобязательный
emailIdstringобязательный
replyAllboolean

email_report_spam

Помечает письмо как спам/нежелательное, обучая собственный спам-фильтр провайдера (тот же сигнал, который отправляет кнопка "Report Junk" в Gmail/Outlook). Это не то же самое, что email_delete: последний удаляет сообщение, но ничему не учит фильтр. Это не жалоба в службу безопасности провайдера на злоупотребления: она только обучает фильтр этого аккаунта.

Параметры

accountIdstringобязательный
emailIdstringобязательный
sourceFolderstring
Source folder (required for IMAP/iCloud when email is not in INBOX)

email_save_attachment

Скачивает вложение из письма и сохраняет его напрямую на диск, возвращая только метаданные (без base64 в ответе), поэтому не приходится тратить токены на передачу больших вложений через вызывающую модель. outputPath задаётся относительно фиксированной директории загрузок (/root/.email-mcp/downloads, переопределяется через EMAIL_MCP_DOWNLOADS_DIR) и не может выйти за её пределы.

Параметры

accountIdstringобязательный
attachmentIdstringобязательный
emailIdstringобязательный
outputPathstringобязательный
Relative file path (within the downloads directory) to save the attachment as

email_search

Ищет письма с фильтрами. По умолчанию возвращает компактные результаты без полного содержимого, чтобы экономить контекст. Установите returnBody=true, чтобы включить полные тела писем.

Параметры

accountIdstringобязательный
beforestring
bodystring
folderstring
fromstring
hasAttachmentboolean
limitnumber
offsetnumber
returnBodyboolean
Include full email body in results (default: false). Set to true only when you need the full content.
sincestring
starredOnlyboolean
subjectstring
tostring
unreadOnlyboolean

email_send

Отправить новое письмо

Параметры

accountIdstringобязательный
bccobject[]
bodyobjectобязательный
ccobject[]
subjectstringобязательный
toobject[]обязательный

email_test_account

Проверить подключение учетной записи электронной почты

Параметры

accountIdstringобязательный
ID of the account to test

email_transfer

Перемещает или копирует письма МЕЖДУ аккаунтами, сохраняя оригинальное сообщение нетронутым (отправитель, дата, цепочка) за счёт передачи сырого MIME. Извлекает каждое сообщение из исходного аккаунта и импортирует его в целевой аккаунт. При deleteAfter=true исходная копия отправляется в корзину только после подтверждённого импорта, что делает это безопасным перемещением между аккаунтами.

Параметры

deleteAfterboolean
Send the source copy to trash after a successful import. Default false (copy, leaving the original in place).
emailIdsstring[]обязательный
Source email IDs to transfer
markReadboolean
Mark imported messages as read in the target. Default: provider default (usually unread).
sourceAccountIdstringобязательный
Account to read messages from
sourceFolderstring
Source folder (required for IMAP/iCloud when emails are not in INBOX)
targetAccountIdstringобязательный
Account to import messages into
targetFolderstring
Destination folder/label in the target account (Gmail label id or name; IMAP/Outlook folder name). Defaults to INBOX.

Github Сайт сервера

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "@marlinjai/email-mcp"
  ]
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

FAQ

Для чего этот сервер?

Этот MCP-сервер даёт AI-агентам прямой доступ к почте: Gmail, Outlook, iCloud и любой IMAP-ящик через единый интерфейс. Он решает задачу интеграции email в ассистентов — Claude умеет искать письма, отправлять ответы, переносить сообщения между аккаунтами и выполнять массовые действия с папками. Всё без ручного переключения между почтовыми клиентами.

Что он умеет?

这个MCP服务器统一管理Gmail、Outlook、iCloud和通用IMAP邮箱，能添加、移除和测试账户连接。搜索邮件时默认只返回紧凑结果，需要完整内容再单独获取，也支持查看线程和下载附件。发送、回复、转发邮件，创建和列出草稿都没问题。整理邮件方面，能移动、删除、标记已读未读或加星，还能打标签和建文件夹。批量操作省时间，一次能删、移、标记多封邮件。垃圾邮件防护也到位，能举报垃圾、创建拦截规则拦截发件人，还能把邮件原样转移到另一个账户。

Информация о сервере

Номер в рейтинге: #197
Звезд на Github: 19
Форков на Github: 15
Загрузок: 7 274
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 10.09 в 21:54
Идентификатор: UWl-LQGni6mMa1Mk
Категории: Автоматизация приложений, Инструменты для разработчиков, Коммуникации, Поиск, Рабочее место и продуктивность, Электронная почта