
Fluxmail
io.github.churichardPublished by GitHub account churichardv0.12.0Updated Nov 3, 2026
Read, search, draft, send, and organize email through Gmail, Outlook, and IMAP/SMTP mailboxes.
The publisher's own server: Fluxmail Cloud
Overview
Self-hosted email server that lets an assistant read, search, draft, send and organize mail across Gmail, Outlook and IMAP/SMTP mailboxes.
- What you can do
- Read and search messages in connected Gmail, Microsoft 365, Outlook.com and IMAP/SMTP mailboxes
- Draft, send and organize email, including folders and labels
- Connect and manage mailboxes and access permissions through the bundled CLI and setup flow
- Expose the same mailbox capabilities to apps and backend workflows over a versioned REST API
- When to use it
- Use it when you want an assistant to work directly with your own mailboxes — triaging, searching, drafting replies or sending messages — while keeping the mail data on infrastructure you run yourself.
- Requirements
- Runs locally as an npm package over stdio; Node.js 22.22 or later. A data directory set by FLUXMAIL_DATA_DIR holds the database, encryption key and settings. Mailbox access needs OAuth or IMAP/SMTP credentials; GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET are optional overrides for a custom Google OAuth client. FLUXMAIL_LICENSE_KEY is optional for paid plan limits.
Installation
In SourceWeft
- Open Fluxmail in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
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.
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.
Source: packages/server/README.md at commit 9a54931
Tools
0Version history
7- v0.12.0LatestOct 5, 2026
- v0.11.2Oct 2, 2026
- v0.11.1Sep 29, 2026
- v0.11.0Sep 26, 2026
- v0.10.0Sep 23, 2026
- v0.9.0Sep 16, 2026
- v0.8.1Sep 16, 2026
Score
40% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts
Declare a license in the repository or the registry entry.
Other Fluxmail integrations
Fluxmail Cloud
ai.fluxmailOfficial publisher
A hosted MCP server that gives an assistant access to your Gmail, Outlook and IMAP mail, with mailboxes and scopes set per agent.

Fluxmail
Published by GitHub account fluxmailai
Self-hosted email server that lets an assistant read, search, draft, send and organize mail in Gmail, Outlook and IMAP/SMTP mailboxes.