mcpField
F
Fluxmail

Fluxmail

Local
fluxmail.aiCommunication7Updated today
RepositoryVisit website

About Fluxmail

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

Key features

  1. 01Connect Gmail and Microsoft mailboxes
  2. 02Support IMAP/SMTP accounts
  3. 03Manage mail through MCP tools
  4. 04Versioned REST API for applications
  5. 05CLI for mailbox and access administration

Use cases

  1. 01Read and organize mailbox messages
  2. 02Search email across connected accounts
  3. 03Draft or send email from an agent
  4. 04Connect email to backend workflows

MCP support

Fluxmail serves email capabilities to agents through MCP. It supports stdio for local MCP clients and Streamable HTTP MCP through its HTTP server, including 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": {
    "churichard-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.12.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.