mcpField
F
Fluxmail

Fluxmail

Local
fluxmail.aiCommunication7Updated today
RepositoryVisit website

About Fluxmail

Fluxmail is self-hosted email infrastructure for agents and apps, connecting Gmail, Microsoft 365, Outlook.com, and IMAP/SMTP mailboxes. It offers MCP, a versioned REST API, and a CLI for email operations and administration.

Key features

  1. 01Connect Gmail, Microsoft 365, Outlook.com, and IMAP/SMTP
  2. 02Read, search, draft, send, and organize email
  3. 03Versioned REST API for apps and workflows
  4. 04CLI for mailbox setup and access management

Use cases

  1. 01Let agents work with connected mailboxes
  2. 02Use email in backend workflows through REST
  3. 03Manage mailbox connections and service access

MCP support

Fluxmail exposes email operations to MCP clients. It supports stdio for local clients and Streamable HTTP for local, Docker, and remote deployments.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "fluxmailai-fluxmail": {
      "command": "npx",
      "args": [
        "-y",
        "fluxmail"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
        "GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
        "FLUXMAIL_DATA_DIR": "<FLUXMAIL_DATA_DIR>",
        "FLUXMAIL_LICENSE_KEY": "<FLUXMAIL_LICENSE_KEY>"
      }
    }
  }
}
Run commandnpx -y fluxmail
Environment variables to set
GOOGLE_CLIENT_IDOptional override for Fluxmail's built-in Desktop OAuth client ID.
GOOGLE_CLIENT_SECRETSecretClient secret paired with a custom Google OAuth client ID.
FLUXMAIL_DATA_DIRDirectory for the Fluxmail database, encryption key, and stored settings.
FLUXMAIL_LICENSE_KEYSecretOptional Fluxmail license key for paid plan limits.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmfluxmail0.19.0

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project 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

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.