Добавить сервер
n24q02m/better-email-mcp
  1. Каталог MCP
  2. n24q02m/better-email-mcp

n24q02m/better-email-mcp

от n24q02m
MCP-сервер для email через IMAP/SMTP: читает, отправляет, управляет папками и вложениями. Поддерживает мультиаккаунты, автонастройку провайдера и app passwords. Упрощает интеграцию почты в AI-агентов.
GithubNPMСайт сервера

email

mcp-name: io.github.n24q02m/better-email-mcp

IMAP/SMTP email for AI agents -- read, send, organize, and manage attachments across accounts.

Mode CI codecov npm Docker License: Apache-2.0

TypeScript Node.js IMAP/SMTP semantic-release Renovate

Sister projects from n24q02m (click to expand)
Project Tagline Tag
agent-chat-plugin Peer AI agents chat in a shared folder — no human relay, no orchestrator, wor... Tooling
better-code-review-graph Knowledge graph for token-efficient code reviews -- semantic search and call-... MCP
better-drive 2-way Google Drive sync with .driveignore filter — rclone engine, Windows tray Tooling
better-email-mcp IMAP/SMTP email for AI agents -- read, send, organize folders, and manage att... MCP
better-godot-mcp Composite MCP server for Godot Engine -- 17 composite tools for AI-assisted g... MCP
better-notion-mcp Markdown-first Notion for AI agents -- pages, databases, blocks, and comments... MCP
better-semantic-release Drop-in python-semantic-release fork with built-in release-safety guards (orp... Tooling
better-telegram-mcp Telegram for AI agents -- messages, chats, media, and contacts across both bo... MCP
better-workspace-mcp Google Workspace MCP server (Docs/Drive/Calendar/Gmail/Sheets/Slides/Tasks/Ch... MCP
claude-plugins Claude Code plugin marketplace for the n24q02m MCP servers -- install web sea... Marketplace
imagine-mcp Image and video understanding + generation for AI agents -- across Gemini, Op... MCP
jules-task-archiver Chrome Extension for bulk operations on Jules tasks via batchexecute API -- a... Tooling
mcp-core Shared foundation for building MCP servers -- Streamable HTTP transport, OAut... MCP
mnemo-mcp Persistent AI memory with hybrid search and embedded sync. Open, free, unlimi... MCP
qwen3-embed Lightweight Qwen3 text embedding and reranking via ONNX Runtime and GGUF Library
skret Secrets without the server. CLI
tacet A self-distilling neuro-symbolic cascade that amortises LLM cost across knowl... Tooling
web-core Shared web infrastructure package for search, scraping, HTTP security, and st... Library
wet-mcp Open-source MCP server for AI agents: web search, content extraction, and lib... MCP

Часто задаваемые вопросы

Инструменты были проиндексированы:
attachmentsтолько чтениеидемпотентный

Список и загрузка вложений электронной почты. Действия (обязательные параметры -> необязательные): - list (account, uid -> folder): отображает вложения с filename, content_type, размером - download (account, uid, filename -> folder): получает содержимое в base64 Сначала используйте list, чтобы получить точные имена файлов. Чувствительность к регистру. Максимум 25 МБ на провайдера.

Параметры
  • accountstringобязательный

    Электронная почта аккаунта (обязательно)

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

    Выполняемое действие.

  • filenamestring

    Точное имя файла вложения из действия со списком (требуется для загрузки). С учетом регистра.

  • folderstring

    Папка почтового ящика (по умолчанию: INBOX)

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

    UID (обязательно)

configвнешний мир

Управление настройкой учётных данных email и конфигурацией во время выполнения. Действия настройки (жизненный цикл учётных данных): - status: Показывает текущее состояние учётных данных, URL настройки и настроенные аккаунты. - setup_start (-> force): Запускает сессию настройки relay и возвращает URL настройки. Установите force=true, чтобы перезапустить, даже если процесс уже идёт. - setup_reset: Удаляет все сохранённые учётные данные и сбрасывает состояние в awaiting_setup. - setup_complete: Повторно проверяет состояние учётных данных после внешних изменений конфигурации (например, отправки relay). Действия во время выполнения: - set: Обновляет настройки времени выполнения (у email нет настроек времени выполнения; возвращает ok=false). - cache_clear: Очищает кэш аккаунтов и OAuth-токенов в памяти.

Параметры
  • actionenumобязательный

    Выполняемое действие.

  • forceboolean

    Принудительно перезапустить настройку реле, даже если она уже выполняется (для действия setup_start).

config__open_relayвнешний мир

Открывает форму конфигурации ретранслятора для better-email-mcp в браузере пользователя. Возвращает URL ретранслятора, был ли запущен браузер и текущее состояние учётных данных.

Параметры

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

foldersтолько чтениеидемпотентный

Выводит список папок почтового ящика или читает метаданные статуса целевого почтового ящика. Actions (required params -> optional): - list (-> account): имена папок, пути и флаги для одного или всех аккаунтов - status (account, folder): сообщения IMAP STATUS, количество непрочитанных и uid_next для ровно одного почтового ящика

Параметры
  • accountstring

    Email или ID аккаунта (обязательно для проверки статуса; необязательный фильтр для списка, по умолчанию — все)

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

    Выполняемое действие.

  • folderstring

    Точный путь к почтовому ящику (требуется для статуса, например INBOX)

helpтолько чтениеидемпотентный

Получает полную документацию для инструмента. Используйте, когда сжатых описаний недостаточно.

Параметры
  • tool_nameenumобязательный

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

messagesвнешний мир

Ищет, читает, управляет, составляет и отправляет электронные письма. Действия (обязательные параметры -> необязательные): - search (-> account, query="UNSEEN", folder="INBOX", limit=20) - read (account, uid -> folder, preview, max_chars) - mark_read / mark_unread / flag / unflag (account, uid|uids -> folder) - move (account, uid|uids, destination -> folder) - archive / trash (account, uid|uids -> folder) - new (account, to, subject, body -> cc, bcc, attachments) - reply (account, uid, body -> to, folder, attachments) - forward (account, uid, to, body -> folder, attachments) Режим предпросмотра read возвращает не более max_chars (по умолчанию 4000) и включает метаданные об усечении; опустите preview, чтобы получить полное тело письма. Примеры запросов: "UNREAD", "FROM user@example.com", "SINCE 2026-01-01", "UNREAD FROM boss@company.com". Формат даты ОБЯЗАН быть YYYY-MM-DD. Исходящие письма поддерживают обычный текст или HTML. Вложения используют содержимое base64, максимум 10 файлов и 25MB в декодированном виде.

Параметры
  • accountstring

    Фильтр email аккаунта (необязательно; по умолчанию - все при поиске).

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

    Выполняемое действие.

  • attachmentsobject[]

    Вложения файлов для включения (необязательно). Максимум 10 файлов, общий декодированный размер не более 25 МБ.

  • bccstring

    Получатели скрытой копии (через запятую)

  • bodystring

    Тело письма (обязательно для нового/ответа/пересылки). Используйте обычный текст или HTML, но не оба.

  • ccstring

    Получатели копии (через запятую)

  • destinationstring

    Целевая папка для перемещения

  • folderstring

    Папка почтового ящика (по умолчанию: INBOX)

  • limitnumber

    Максимум результатов поиска (по умолчанию: 20)

  • max_charsnumber

    Ограничение размера тела для предпросмотра, целое число от 1 до 100000; по умолчанию 4000, если preview равен true.

  • previewboolean

    Читает не более max_chars и возвращает метаданные усечения

  • querystring

    IMAP-запрос поиска (по умолчанию: UNSEEN). Одиночные: UNREAD, FLAGGED, SINCE ГГГГ-ММ-ДД, FROM email@example.com, SUBJECT текст. Комбинированные: UNREAD SINCE 2026-01-01, UNREAD FROM user@example.com. Даты ОБЯЗАНЫ использовать формат ГГГГ-ММ-ДД (например, 2026-03-21). Обычный текст рассматривается как поиск по теме.

  • subjectstring

    Тема письма (обязательна для нового)

  • tostring

    Адрес электронной почты получателя (обязателен для нового письма или пересылки, необязателен для ответа — автоматически подставляется из отправителя исходного письма)

  • uidnumber

    Email UID (для чтения/изменения одного письма)

  • uidsnumber[]

    Несколько UID для пакетных операций

1.41.5основная
1.41.4
1.41.3
1.41.2
1.41.1
1.41.0
1.40.1
1.40.1-beta.1
1.40.0
1.39.0
1.39.0-beta.2
1.39.0-beta.1
1.38.3
1.38.3-beta.2
1.38.3-beta.1
1.38.2
1.38.1
1.38.0
1.37.0
1.37.0-beta.3
1.37.0-beta.2
1.37.0-beta.1
1.36.0
1.36.0-beta.1
1.35.0
1.35.0-beta.4
1.35.0-beta.3
1.35.0-beta.2
1.35.0-beta.1
1.34.2-beta.2
1.34.2-beta.1
1.34.1
1.34.1-beta.1
1.34.0
1.34.0-beta.1
1.33.0
1.33.0-beta.7
1.33.0-beta.6
1.33.0-beta.5
1.33.0-beta.4
1.33.0-beta.3
1.33.0-beta.2
1.33.0-beta.1
1.32.3-beta.2
1.32.3-beta.1
1.32.2
1.32.2-beta.1
1.32.1
1.32.0
1.32.0-beta.1
1.31.3
1.31.3-beta.1
1.31.2
1.31.1
1.31.1-beta.1
1.31.0
1.31.0-beta.1
1.30.0
1.30.0-beta.2
1.30.0-beta.1
1.29.0
1.29.0-beta.1
1.28.0
1.28.0-beta.1
1.27.0
1.27.0-beta.7
1.27.0-beta.6
1.27.0-beta.5
1.27.0-beta.4
1.27.0-beta.3
1.27.0-beta.2
1.27.0-beta.1
1.26.3
1.26.2
1.26.2-beta.1
1.26.1
1.26.0
1.25.2
1.25.1
1.25.0
1.24.1-beta.1
1.24.0
1.23.9
1.23.8
1.23.7
1.23.6
1.23.5
1.23.4
1.23.2
1.23.1
1.23.0
1.23.0-beta.1
1.22.6
1.22.5
1.22.4
1.22.3
1.22.2
1.22.1
1.22.0
1.21.0
1.20.0
1.19.0
1.18.0
1.18.0-beta.1
1.17.0
1.17.0-beta.2
1.17.0-beta.1
1.16.0
1.15.0
1.15.0-beta.1
1.14.0
1.14.0-beta.2
1.14.0-beta.1
1.13.0
1.12.0
1.11.0
1.11.0-beta.2
1.10.1
1.10.0
1.9.0
1.8.0
1.7.0
1.6.0
1.5.0
1.4.7
1.4.6
1.4.5
1.4.4
1.4.3
1.4.2
1.4.1
1.4.0
1.3.0
1.2.5
1.2.4
1.2.3
1.2.2
1.2.1
1.2.0
1.1.0
1.0.2
1.0.1
1.0.0

Выберите клиент, чтобы установить n24q02m/better-email-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "n24q02m-better-email-mcp-r677visx8d": {
      "command": "npx",
      "args": [
        "--yes",
        "@n24q02m/better-email-mcp@latest"
      ],
      "env": {
        "EMAIL_CREDENTIALS": "user@gmail.com:app-password"
      }
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "n24q02m-better-email-mcp-r677visx8d": {
      "command": "npx",
      "args": [
        "--yes",
        "@n24q02m/better-email-mcp@latest"
      ],
      "env": {
        "EMAIL_CREDENTIALS": "user@gmail.com:app-password"
      }
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "n24q02m-better-email-mcp-r677visx8d": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "--yes",
        "@n24q02m/better-email-mcp@latest"
      ],
      "env": {
        "EMAIL_CREDENTIALS": "user@gmail.com:app-password"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"n24q02m-better-email-mcp-r677visx8d\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"--yes\",\"@n24q02m/better-email-mcp@latest\"],\"env\":{\"EMAIL_CREDENTIALS\":\"user@gmail.com:app-password\"}}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "n24q02m-better-email-mcp-r677visx8d": {
      "command": "npx",
      "args": [
        "--yes",
        "@n24q02m/better-email-mcp@latest"
      ],
      "env": {
        "EMAIL_CREDENTIALS": "user@gmail.com:app-password"
      }
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add n24q02m-better-email-mcp-r677visx8d --env EMAIL_CREDENTIALS=user@gmail.com:app-password -- npx --yes @n24q02m/better-email-mcp@latest

Либо через JSON-конфиг:

claude mcp add-json n24q02m-better-email-mcp-r677visx8d "{\"command\":\"npx\",\"args\":[\"--yes\",\"@n24q02m/better-email-mcp@latest\"],\"env\":{\"EMAIL_CREDENTIALS\":\"user@gmail.com:app-password\"}}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add n24q02m-better-email-mcp-r677visx8d --env EMAIL_CREDENTIALS=user@gmail.com:app-password -- npx --yes @n24q02m/better-email-mcp@latest

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.n24q02m-better-email-mcp-r677visx8d]
command = "npx"
args = ["--yes", "@n24q02m/better-email-mcp@latest"]

[mcp_servers.n24q02m-better-email-mcp-r677visx8d.env]
EMAIL_CREDENTIALS = "user@gmail.com:app-password"
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите n24q02m/better-email-mcp, а в поле команды запуска — строку ниже:
npx --yes @n24q02m/better-email-mcp@latest

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "n24q02m-better-email-mcp-r677visx8d": {
      "command": "npx",
      "args": [
        "--yes",
        "@n24q02m/better-email-mcp@latest"
      ],
      "env": {
        "EMAIL_CREDENTIALS": "user@gmail.com:app-password"
      }
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "n24q02m-better-email-mcp-r677visx8d": {
      "command": "npx",
      "args": [
        "--yes",
        "@n24q02m/better-email-mcp@latest"
      ],
      "env": {
        "EMAIL_CREDENTIALS": "user@gmail.com:app-password"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например n24q02m-better-email-mcp-r677visx8d.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: n24q02m-better-email-mcp-r677visx8d
    command: npx
    args:
      - "--yes"
      - "@n24q02m/better-email-mcp@latest"
    env:
      EMAIL_CREDENTIALS: user@gmail.com:app-password
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "n24q02m-better-email-mcp-r677visx8d": {
      "command": "npx",
      "args": [
        "--yes",
        "@n24q02m/better-email-mcp@latest"
      ],
      "env": {
        "EMAIL_CREDENTIALS": "user@gmail.com:app-password"
      }
    }
  }
}

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

codefuturist/email-mcp

codefuturist/email-mcp

от codefuturist

MCP сервер для email: читает, отправляет, планирует и анализирует письма через IMAP и SMTP. Сервер поддерживает несколько аккаунтов, OAuth2 и real-time мониторинг. Полезен для подключения почты к AI-ассистентам.

TypeScript⭐ 133
shy2593666979/mcp-server-email

shy2593666979/mcp-server-email

от shy2593666979

MCP сервер для отправки email и поиска вложений. Даёт AI-ассистентам возможность составлять и отправлять письма с вложениями, а также искать файлы по шаблону. Использует SMTP, поддерживает нескольких получателей.

Python⭐ 81
TheSameAbramovych/qmailing-mcp-server

TheSameAbramovych/qmailing-mcp-server

от thesameabramovych

MCP сервер для интеграции AI-агентов с почтовым сервисом QMailing. Позволяет управлять ящиками, отправлять и читать письма, работать с вложениями и вебхуками. Подключается к Claude.ai через OAuth или к другим MCP-клиентам через npm. Требует тариф PLUS.

TypeScript⭐ 1
wyattjoh/jmap-mcp

wyattjoh/jmap-mcp

от wyattjoh

MCP-сервер для работы с JMAP-почтой: поиск, чтение, отправка, перемещение и удаление писем, управление папками и синхронизация. Полезен разработчикам, автоматизирующим почту через FastMail, Cyrus и...

TypeScript⭐ 177
sethbang/proton-mail-mcp

sethbang/proton-mail-mcp

от sethbang

MCP-сервер, дающий AI-ассистентам полный доступ к Proton Mail: отправлять, читать, искать, организовывать с папками, метками и массовыми операциями через SMTP/IMAP. Полезен разработчикам, создающим...

TypeScript⭐ 7
mailgun/mailgun-mcp-server

mailgun/mailgun-mcp-server

от mailgun

MCP сервер для Mailgun позволяет AI агентам отправлять email, управлять доставляемостью, доменами и аналитикой. Идеален для разработчиков, автоматизирующих почтовые процессы через MCP инструмент с поддержкой валидации и тестов доставляемости.

TypeScript⭐ 62
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин