io.github.churichard/fluxmail (MCP Server)

This MCP server reads, searches, drafts, sends, and organizes email through Gmail, Outlook, and IMAP/SMTP mailboxes. It is described as self-hosted email infrastructure for agents and apps, with agents using MCP and apps/workflows using a versioned REST API.

🛠️ Key Features

Email access across Gmail, Microsoft 365, Outlook.com, and IMAP/SMTP
Read, search, draft, send, and organize email
MCP for agents; versioned REST API for apps and backend workflows
CLI for operators to connect mailboxes, manage access, and run the service

🚀 Use Cases

Agent workflows that interact with email via MCP
Application and backend workflows that use the versioned REST API
Operator-driven mailbox setup and service operation via CLI

⚡ Developer Benefits

Standard integration patterns: MCP (agents) and REST API (apps/workflows)
Supports common mailbox providers and protocols (Gmail, Microsoft 365/Outlook, IMAP/SMTP)
CLI commands for connecting mailboxes and managing access

⚠️ Limitations

Requires Node.js 20.20.x or Node.js 22.22+ to install and run

Supported Topics

ai, ai-agent, ai-agents, api, cli, email, mcp, mcp-server

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.

Install

Configuration

Environment variables

GOOGLE_CLIENT_ID

Optional override for Fluxmail's built-in Desktop OAuth client ID.

GOOGLE_CLIENT_SECRETsecret

Client secret paired with a custom Google OAuth client ID.

FLUXMAIL_DATA_DIR

Directory for the Fluxmail database, encryption key, and stored settings.

FLUXMAIL_LICENSE_KEYsecret

Optional Fluxmail license key for paid plan limits.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "fluxmail": {
      "command": "npx",
      "args": [
        "-y",
        "fluxmail@0.11.1",
        "stdio"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "<YOUR_GOOGLE_CLIENT_ID>",
        "GOOGLE_CLIENT_SECRET": "<YOUR_GOOGLE_CLIENT_SECRET>",
        "FLUXMAIL_DATA_DIR": "<YOUR_FLUXMAIL_DATA_DIR>",
        "FLUXMAIL_LICENSE_KEY": "<YOUR_FLUXMAIL_LICENSE_KEY>"
      }
    }
  }
}

io.github.churichard/fluxmail (MCP Server)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Supported Topics

Topics

Fluxmail

Install

Documentation

License

Install

Configuration

Related servers