Better Email MCP

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/n24q02m-better-email-mcp

About

Use cases: email

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools

3 read · 3 write · 0 delete

Secrets

1 (API keys, tokens or passwords)

Install scripts

None found

Runs as

Node.js package

Tools (6)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• attachmentsAttachmentsread-only

  List and download email attachments. Actions (required params -> optional): - list (account, uid -> folder): show attachments with filename, content_type, size - download (account, uid, filename -> folder): get base64-encoded content Use list first to get exact filenames. Case-sensitive. Max 25MB per provider.

• configConfig

  Manage email credential setup and runtime configuration. Setup actions (credential lifecycle): - status: Show current credential state, setup URL, and configured accounts - setup_status: Show credential state and setup URL only (no accounts list; cross-server parity action) - setup_start (-> force): Trigger relay setup session and return the setup URL. Set force=true to restart even if already in progress - setup_reset: Clear all saved credentials and reset to awaiting_setup state - setup_complete: Re-check credential state after external config changes (e.g. relay submission) Runtime action…

• config__open_relayOpen Relay

  Open the relay configuration form for better-email-mcp in the user browser. Returns the relay URL, whether the browser launched, and the current credential state.

• foldersFoldersread-only

  List mailbox folders or read targeted mailbox status metadata. Actions (required params -> optional): - list (-> account): folder names, paths, and flags for one or all accounts - status (account, folder): IMAP STATUS messages, unseen, and uid_next for exactly one mailbox

• helpHelpread-only

  Get full documentation for a tool. Use when compressed descriptions are insufficient.

• messagesMessages

  Search, read, manage, compose, and send email messages. Actions (required params -> optional): - 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 preview mode returns at most max_chars …

Signals

Stars

35

Forks

18

Open issues

1

Contributors

7

Weekly downloads

273

Last commit

Oct 11, 2026 (19 days ago)

Last release

Sep 13, 2026 (1 month ago)

Last package publish

Sep 13, 2026 (1 month ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.n24q02m/better-email-mcp

Version

1.41.5

Auth

API key

Packages

npm @n24q02m/better-email-mcpoci docker.io/n24q02m/better-email-mcp:latest

License

Apache-2.0

Repository

github.com/n24q02m/better-email-mcp

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql