Plugin

better-email-mcp

Name: better-email-mcp
Author: n24q02m

Triage and automate multiple IMAP/SMTP email accounts locally: scan inboxes for unread threads grouped by subject, classify priorities (Action Required, FYI, Low) from senders and flags, detect unanswered follow-ups across folders and drafts, then generate contextual reply drafts—all via npx stdio subprocess, no API keys needed.

npx claudepluginhub n24q02m/better-email-mcp

Component Overview

Skills

MCP Servers

Setup Configuration

This plugin requires configuration values that are prompted when the plugin is enabled. Sensitive values are stored in your system keychain.

EMAIL_CREDENTIALS

sensitive

Format: user@gmail.com:app-password (multi: user1@x:p1,user2@y:p2)

${user_config.EMAIL_CREDENTIALS}

Component Details

Skills (2)

follow-up

/follow-up

Find emails needing follow-up -- unanswered sent emails, flagged unreplied, draft contextual responses

inbox-review

/inbox-review

Morning inbox workflow -- multi-account scan, thread grouping, priority classification, draft replies

MCP Servers (1)

Connects to external services

better-email-mcp

1 secret

README

Better Email MCP

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

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

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<auto>, 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<auto>+ and follow the current docs/setup-manual.md -- most prior workarounds are no longer needed.

Related plugins from the same author:

wet-mcp -- Web search + content extraction

mnemo-mcp -- Persistent AI memory

imagine-mcp -- Image/video understanding + generation

better-notion-mcp -- Notion API

better-email-mcp -- Email management

better-telegram-mcp -- Telegram

better-godot-mcp -- Godot Engine

better-code-review-graph -- Code review knowledge graph

All plugins share the same architecture -- install once, learn pattern transfers.

Setup

Stdio mode (default) -- env var creds (EMAIL_PROVIDER + EMAIL_USER + EMAIL_APP_PASSWORD), single-user local. See setup-manual.md.
HTTP mode (optional, encouraged) -- multi-user, browser-based setup with bundled Outlook OAuth. See setup-manual.md "Method 5: Self-Hosting HTTP Mode".

With AI Agent -- copy and send this to your AI agent:

Please set up @n24q02m/better-email-mcp for me. Follow this guide: https://raw.githubusercontent.com/n24q02m/better-email-mcp/main/docs/setup-with-agent.md

Manual Setup -- follow docs/setup-manual.md

Tools

View full README on GitHub

Similar Plugins

apple-mail

Natural language interface for Apple Mail — search, compose, triage, organize, and analyze email with 24 MCP tools and an expert email management skill

Stats

Version1.27.0

Stars12

Forks4

MaintenanceExcellent

Last CommitMay 5, 2026

AddedMar 25, 2026

Actions

View on GitHub View README Plugin Marketplace JSON

Safety Signals

Caution

Requires secrets

Needs API keys or credentials to function

Help us improve

Share bugs, ideas, or general feedback.

Back to Plugins

better-email-mcp

Better Email MCP

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

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

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<auto>, 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<auto>+ and follow the current docs/setup-manual.md -- most prior workarounds are no longer needed.

Related plugins from the same author:

wet-mcp -- Web search + content extraction
mnemo-mcp -- Persistent AI memory
imagine-mcp -- Image/video understanding + generation
better-notion-mcp -- Notion API
better-email-mcp -- Email management
better-telegram-mcp -- Telegram
better-godot-mcp -- Godot Engine
better-code-review-graph -- Code review knowledge graph

All plugins share the same architecture -- install once, learn pattern transfers.

Setup

Stdio mode (default) -- env var creds (EMAIL_PROVIDER + EMAIL_USER + EMAIL_APP_PASSWORD), single-user local. See setup-manual.md.

HTTP mode (optional, encouraged) -- multi-user, browser-based setup with bundled Outlook OAuth. See setup-manual.md "Method 5: Self-Hosting HTTP Mode".

With AI Agent -- copy and send this to your AI agent:

Tools

better-email-mcp

Component Overview

Setup Configuration