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

AI-generated 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.
Before you install
The server stores an encryption key and mailbox settings in the data directory, so protect that directory. It can send and delete or reorganize mail, so review actions before granting broad use. It holds OAuth client secrets and mailbox credentials; a custom GOOGLE_CLIENT_SECRET is a secret to keep out of shared configs. Mail content is processed by the assistant you connect.

Installation

In SourceWeft

  1. Open Fluxmail in the dashboard and add it to a workspace.
  2. 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.

bash
npm install -g fluxmailfluxmail 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

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

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

7
  1. v0.12.0LatestOct 5, 2026
  2. v0.11.2Oct 2, 2026
  3. v0.11.1Sep 29, 2026
  4. v0.11.0Sep 26, 2026
  5. v0.10.0Sep 23, 2026
  6. v0.9.0Sep 16, 2026
  7. 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