fluxmail
v0.15.0
Published
Self-hosted email API with MCP and REST support for Gmail, Outlook, and IMAP/SMTP
Maintainers
Readme
Fluxmail
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 mailboxes, manage access, and run the service.
Install
Fluxmail requires Node.js 22.22 or later.
npm install -g fluxmail
fluxmail setup --name "Your name" --email [email protected]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
- Authentication and instances
Fluxmail supports stdio for local MCP clients. Its HTTP server provides Streamable HTTP MCP and REST for local, Docker, and remote deployments. Use an exact package version instead of @latest when you need a reproducible installation.
License
Fluxmail is source available under the Elastic License 2.0. You may use, modify, create derivative works, and redistribute it subject to that license. The Personal plan supports three mailboxes and one member without a paid key. Official Pro, Business, and Enterprise entitlements require a valid Fluxmail license key.
