Fluxmail

<p align="center"> <img src="docs/assets/fluxmail-banner.png" alt="Fluxmail" width="100%"> </p>

<p align="center"><a href="https://github.com/churichard/fluxmail/actions/workflows/ci.yml"><img alt="CI" src="https://img.shields.io/github/actions/workflow/status/churichard/fluxmail/ci.yml?branch=main&style=flat-square&label=CI&logo=github"></a> <a href="https://www.npmjs.com/package/fluxmail"><img alt="npm version" src="https://img.shields.io/npm/v/fluxmail?style=flat-square&logo=npm&color=1f4fcc"></a> <a href="https://github.com/churichard/fluxmail/pkgs/container/fluxmail"><img alt="Container image" src="https://img.shields.io/badge/GHCR-container-2496ED?style=flat-square&logo=docker&logoColor=white"></a></p>

Fluxmail is self-hosted email infrastructure for agents and apps. It connects to Gmail, Microsoft 365, Outlook.com, and IMAP/SMTP mailboxes. Agents use MCP, apps and backend workflows use the versioned REST API, and operators use the CLI to connect accounts, manage access, and run the service.

Get started

Fluxmail requires Node.js 20.20.x, or Node.js 22.22 or later.

npm install -g fluxmail
fluxmail setup --name "Your name" --email you@example.com

Then follow the quickstart to connect a mailbox and choose how you want to use Fluxmail: MCP, REST API, or CLI.

Documentation

• Overview
• MCP tools
• Build with REST
• REST API
• Permissions
• Configuration
• CLI reference
• Gmail setup
• Outlook setup
• IMAP setup
• Architecture
• Teams and plans
• Authentication and instances

Plans and license

The Personal plan supports three mailboxes and one member. Paid plans raise those limits for teams that share an instance. See Fluxmail pricing for current details.

Fluxmail is proprietary, source-available software. You may inspect, test, and privately modify the source, but production use is limited to your Fluxmail entitlement. Redistribution, hosted resale, competing use, and bypassing license controls are not permitted. See LICENSE.md for the full terms.