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

marlinjai/email-mcp

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

README

25 инструментов

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

@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:

email_add_account

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

Параметры

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

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
readboolean
starredboolean
flaggedboolean
sourceFolderstring
Source folder (required for IMAP/iCloud when emails are not in INBOX)

email_batch_move

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

Параметры

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

email_delete

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

Параметры

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

email_draft_create

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

Параметры

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

email_draft_list

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

Параметры

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

email_folder_create

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

Параметры

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

email_forward

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

Параметры

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

email_get

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

Параметры

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

email_get_attachment

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

Параметры

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

email_get_categories

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

Параметры

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

email_get_labels

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

Параметры

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

email_get_thread

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

Параметры

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

email_label

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

Параметры

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

email_list_accounts

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

Параметры

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

email_list_folders

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

Параметры

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

email_mark

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

Параметры

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

email_move

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

Параметры

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

email_remove_account

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

Параметры

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

email_reply

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

Параметры

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

email_search

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

Параметры

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

email_send

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

Параметры

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

email_test_account

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

Параметры

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

email_transfer

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

Параметры

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

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

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

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

Также marlinjai/email-mcp можно установить в Cursor по ссылке автоматически.

FAQ

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

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

Что он умеет?

Управляет почтовыми аккаунтами — добавляет, удаляет, тестирует и показывает их статус. Ищет письма с фильтрами, читает письма и целые цепочки, скачивает вложения. Отправляет, отвечает, пересылает письма, создаёт и просматривает черновики. Организует почту — перемещает между папками, удаляет, помечает прочитанным, звёздочкой или флагом, добавляет метки (Gmail) и категории (Outlook), создаёт папки. Массово удаляет, перемещает и помечает сотни писем. Копирует и переносит письма между разными аккаунтами, сохраняя все исходные данные.

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

Номер в рейтинге: #184
Звезд на Github: 16
Форков на Github: 13
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 16.07 в 22:12
Идентификатор: UWl-LQGni6mMa1Mk
Категории: Автоматизация приложений, Инструменты для разработчиков, Коммуникации, Поиск, Рабочее место и продуктивность, Электронная почта

Другие проверенные MCP-сервера

OctagonAI/octagon-mcp-server

официальный

Octagon MCP сервер для AI-финансовых исследований: интегрируется с Market Intelligence API, извлекает инсайты из SEC-отчетов, отчетов о прибылях, данных по акциям/криптовалютам и prediction markets. Полезен инвесторам и аналитикам для глубокого анализа рынков.

pinecone-io/assistant-mcp

официальный

MCP-сервер на Rust для получения данных от Pinecone Assistant. Укажите API-ключ и лимит результатов. Интеграция с ИИ-инструментами через Docker. Для разработчиков поисковых ассистентов.

mcpjungle/mcpjungle

MCPJungle - шлюз для управления несколькими MCP-серверами через единый endpoint. Упрощает настройку клиентов, централизует доступ и мониторинг. Работает локально или как командная инфраструктура для Claude, Cursor.

taylorwilsdon/google_workspace_mcp

Google Workspace MCP сервер для полного управления сервисами через естественный язык - Gmail, Drive, Calendar, Docs, Sheets и другие. Поддерживает OAuth 2.1 и многопользовательский режим. Идеален д...

ClickHouse/mcp-clickhouse

официальный

MCP сервер для работы с ClickHouse: выполняет SQL-запросы, перечисляет базы и таблицы с пагинацией. Поддерживает chDB для быстрых встраиваемых запросов без ETL. Полезен разработчикам и аналитикам для интеграции ClickHouse в AI-инструменты через MCP.

makenotion/notion-mcp-server

официальный

Notion MCP сервер даёт AI-агентам прямой доступ к Notion через API: читайте и редактируйте страницы в Markdown, делайте запросы к данным. Разработчики используют этот MCP инструмент для интеграции помощников с заметками и проектами, экономя токены.