Fluxmail

Lets an assistant read, search, draft, send, and organize email across Gmail, Outlook, and IMAP/SMTP mailboxes.

What it does

Fluxmail is self-hosted email infrastructure that connects to Gmail, Microsoft 365, Outlook.com, and IMAP/SMTP mailboxes. Through MCP, an assistant can read, search, draft, send, and organize mail; the same service also exposes a versioned REST API for apps and a CLI for connecting mailboxes and managing access. It runs locally over stdio for MCP clients, and its HTTP server offers Streamable HTTP MCP and REST for local, Docker, or remote deployments.

When to use it

Use it when an assistant needs to work with real mailboxes rather than a single provider's API, for example triaging, searching, drafting, or sending email across Gmail, Microsoft 365, Outlook.com, or generic IMAP/SMTP accounts. It suits users who want to self-host the email layer and manage mailbox access themselves.

Requirements

Node.js 20.20.x, or Node.js 22.22 or later, with the npm package fluxmail installed globally. A mailbox connection is needed, and Google OAuth may require GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET if overriding the built-in client. FLUXMAIL_DATA_DIR sets where the database, encryption key, and settings are stored; FLUXMAIL_LICENSE_KEY is optional for paid plan limits.