@n24q02m/better-email-mcp

communication MCP Server

IMAP/SMTP email server for AI agents -- 6 composite tools with multi-account and auto-discovery

Install Ready
communicationcommunication
5 views22 stars9 forksv1.32.1MIT

Why This Matters

Discovered via unknown and last synced 3mo ago.

Install Ready
Source
unknown
Stars
22
Last synced
3mo ago
Install
Instructions detected

Install

1. Install the package

npx --yes @n24q02m/better-email-mcp@latest

2. Add to claude_desktop_config.json

{
  "mcpServers": {
    "n24q02m-better-email-mcp": {
      "command": "npx",
      "args": [
        "--yes",
        "@n24q02m/better-email-mcp@latest"
      ]
    }
  }
}

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%\Claude\claude_desktop_config.json (Windows)

36
Tools
0
Resources
0
Prompts
Standard I/O
Transport

Available Tools (36)

EMAIL_USER

Yes (stdio, single-account)

OUTLOOK_EMAIL

No

ProtonMail

ProtonMail Bridge

setup

`status`, `start`, `reset`, `complete`

Provider

Auth

send

`new`, `reply`, `forward`

Variable

Required

PORT

No

URI

Description

DCR_SERVER_SECRET

Yes (http)

Gmail

App Password

folders

`list`

EMAIL_APP_PASSWORD

Yes (stdio, single-account)

Tool

Actions

EMAIL_PROVIDER

Yes (stdio, single-account)

OUTLOOK_CLIENT_ID

No

attachments

`list`, `download`

EMAIL_IMAP_HOST

No (custom only)

UNREAD

Unread emails

Mode

Storage

EMAIL_CREDENTIALS

Alternative (multi-account)

FLAGGED

Starred emails

Same

Only you (admin = user)

Query

Description

Custom

Via `email:pass:imap.host`

TRANSPORT_MODE

No

PUBLIC_URL

No (http)

Yahoo

App Password

Zoho

App Password

Project

Tagline

messages

`search`, `read`, `mark_read`, `mark_unread`, `flag`, `unflag`, `move`, `archive`, `trash`

MCP_AUTH_DISABLE

No (http)

MCP

</details> <!-- END: AUTO-GENERATED-CROSS-PROMO --> ## Table of contents - [Features](#features) - [Status](#status) - [Documentation](#documentation) - [Tools](#tools) - [Remote (HTTP Mode)](#remote-http-mode) - [Outlook OAuth Device Code (HTTP mode)](#outlook-oauth-device-code-http-mode) - [Configuration](#configuration) - [Security](#security) - [Build from Source](#build-from-source) - [Trust Model](#trust-model) - [License](#license) <a href="https://glama.ai/mcp/servers/n24q02m/better-email-mcp"> <img width="380" height="200" src="https://glama.ai/mcp/servers/n24q02m/better-email-mcp/badge" alt="Better Email MCP server" /> </a> ## Features - **Multi-account support** -- manage 6+ email accounts (Gmail, Outlook, Yahoo, iCloud, Zoho, ProtonMail, custom IMAP) - **App Passwords** -- no OAuth2 setup required for most providers; clone and run in 1 minute - **6 composite tools** with 20 actions -- search, read, send, reply, forward, organize, credential setup in single calls - **Auto-discovery** -- provider settings detected from email address, custom IMAP host supported - **Thread-aware** -- reply/forward maintains In-Reply-To and References headers - **Tiered token optimization** -- compressed descriptions + on-demand `help` tool + MCP Resources ## Status > **2026-05-02 -- Architecture stabilization update** > > Past months saw significant churn around credential handling and the daemon-bridge auto-spawn pattern. This caused multi-process races, browser tab spam, and inconsistent setup UX across plugins. **As of v&lt;auto&gt;, the architecture is stable**: 2 clean modes (stdio + HTTP), no daemon-bridge layer, no auto-spawn from stdio. > > Apologies for the instability period. If you encountered issues with prior versions, please update to v&lt;auto&gt;+ and follow the current [Setup guide](https://mcp.n24q02m.com/servers/better-email-mcp/setup/) -- most prior workarounds are no longer needed. > > **Related plugins from the same author**: > - [wet-mcp](https://github.com/n24q02m/wet-mcp) -- Web search + content extraction > - [mnemo-mcp](https://github.com/n24q02m/mnemo-mcp) -- Persistent AI memory > - [imagine-mcp](https://github.com/n24q02m/imagine-mcp) -- Image/video understanding + generation > - [better-notion-mcp](https://github.com/n24q02m/better-notion-mcp) -- Notion API > - [better-email-mcp](https://github.com/n24q02m/better-email-mcp) -- Email management > - [better-telegram-mcp](https://github.com/n24q02m/better-telegram-mcp) -- Telegram > - [better-godot-mcp](https://github.com/n24q02m/better-godot-mcp) -- Godot Engine > - [better-code-review-graph](https://github.com/n24q02m/better-code-review-graph) -- Code review knowledge graph > > All plugins share the same architecture -- install once, learn pattern transfers. ## Documentation Full docs at **[mcp.n24q02m.com/servers/better-email-mcp/](https://mcp.n24q02m.com/servers/better-email-mcp/)**: - [Setup](https://mcp.n24q02m.com/servers/better-email-mcp/setup/) -- install methods for Claude Code, Codex, Gemini CLI, Cursor, Windsurf, mcp.json - [Modes overview](https://mcp.n24q02m.com/get-started/modes-overview/) -- stdio / local-relay / remote-relay / remote-oauth - [Multi-user setup](https://mcp.n24q02m.com/get-started/multi-user/) -- per-JWT-sub credential model **Install with AI agent** -- paste this to your AI coding agent: > Install MCP server `better-email-mcp` following the steps at > https://raw.githubusercontent.com/n24q02m/claude-plugins/main/plugins/better-email-mcp/setup-with-agent.md ## Tools

CREDENTIAL_SECRET

No (http)

Actions

Description

HOST

No