Read, search, draft, send, and organize email through Gmail, Outlook, and IMAP/SMTP mailboxes.

How do I install Fluxmail?

Install Fluxmail via npm from https://registry.npmjs.org, then add the server config to your MCP client (Claude Desktop, Cursor, or VS Code).

Is Fluxmail open source?

Yes, Fluxmail is open source under the NOASSERTION license. Source code is available at https://github.com/churichard/fluxmail.

What category does Fluxmail belong to?

Fluxmail is listed under Communication MCP servers on MCPFind.

Fluxmail — MCP Server for Communication

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.

Features

📬 Connect Gmail, Google Workspace, Microsoft 365, Outlook.com, and IMAP/SMTP mailboxes to one instance.
🤖 Give agents MCP tools to list, search, read, draft, reply, forward, send, schedule, and organize email.
🔌 Use the same mailbox operations from the versioned REST API and CLI.
🧵 Fetch complete messages and threads, work across several mailboxes, and download attachments.
🗂️ Mark mail as read, star or archive it, move it between folders, send it to Trash, and manage Gmail labels or Outlook categories.
🔐 Limit each client to selected mailboxes and actions with permission profiles or custom policies.
👥 Add members and share selected mailboxes on Team and Enterprise plans.
🏠 Run Fluxmail locally or in Docker while keeping its database and encrypted provider credentials on your infrastructure.

Get started

Fluxmail requires Node.js 20.20.x, or Node.js 22.22 or later.

npm install -g fluxmail
fluxmail setup --name "Your name" --email you@example.com

Then follow the quickstart to connect a mailbox and choose how you want to use Fluxmail: MCP, REST API, or CLI.

Documentation

Plans and license

The Personal plan supports three mailboxes and one member. Paid plans raise those limits for teams that share an instance. See Fluxmail pricing for current details.

Fluxmail is source available under the Elastic License 2.0. You may use, modify, create derivative works, and redistribute Fluxmail subject to that license. Running a fork does not by itself require a paid Fluxmail subscription, and the built-in Personal plan supports three mailboxes and one member without a paid key.

Official Pro and Team entitlements require a valid Fluxmail license key. ELv2 does not allow you to change or circumvent license key functionality, remove protected functionality, or provide Fluxmail itself as a hosted or managed service that exposes a substantial set of its features. Use of the Fluxmail name and logos is also subject to the Fluxmail Terms of Service.

Set up in your AI client

AI clientOperating system

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json

{
  "mcpServers": {
    "io-github-churichard-fluxmail": {
      "command": "npx",
      "args": [
        "-y",
        "fluxmail"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Compatible MCP Clients

Fluxmail works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.

Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.

VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.

Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.

Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Fluxmail