fluxmail
v0.5.0
Published
Self-hosted email API with MCP and REST support for Gmail, Outlook, and IMAP/SMTP
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 20.20.x, or 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 proprietary, source-available software. Production use is limited to your Fluxmail entitlement. See the repository license for the full terms.
