How do I install Fluxmail?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Fluxmail need an API key?

The publisher lists these environment variables: GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, FLUXMAIL_DATA_DIR, FLUXMAIL_LICENSE_KEY.

What transport does Fluxmail use?

Fluxmail runs locally over stdio.

When was Fluxmail last checked?

Last checked 2026-11-09. Read, search, draft, send, and organize email through Gmail, Outlook, and IMAP/SMTP mailboxes.

Fluxmail MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Credentials from the publisher

GOOGLE_CLIENT_ID — Optional override for Fluxmail's built-in Desktop OAuth client ID.
GOOGLE_CLIENT_SECRET — 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_KEY — Optional Fluxmail license key for paid plan limits.

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1GOOGLE_CLIENT_ID=<value> GOOGLE_CLIENT_SECRET=<secret> FLUXMAIL_DATA_DIR=<value> FLUXMAIL_LICENSE_KEY=<secret> claude mcp add io.github.fluxmailai-fluxmail -- npx -y fluxmail@0.25.0

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.fluxmailai-fluxmail": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ],9      "env": {10        "GOOGLE_CLIENT_ID": "<value>",11        "GOOGLE_CLIENT_SECRET": "<secret>",12        "FLUXMAIL_DATA_DIR": "<value>",13        "FLUXMAIL_LICENSE_KEY": "<secret>"14      }15    }16  }17}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.25.0

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Fluxmail is a self-hosted email MCP server with a versioned REST API and CLI, supporting Gmail, Google Workspace, Microsoft 365, Outlook.com, and IMAP/SMTP mailboxes. Agents use MCP, apps and backend workflows use the REST API, and operators use the CLI to connect mailboxes, manage access, and run the service. Fluxmail Cloud provides a hosted option.

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 choose which mailboxes each can access on Business 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 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.

We recommend Full access for normal MCP use. It allows reading, sending, scheduling, drafts, organization, and moving mail into or out of Trash. It excludes permanent deletion. Choose read-write or read-only for restricted access. Bare stdio and API-key creation without permission options remain read-only.

For a local MCP connection, configure your client to launch fluxmail with arguments ["stdio", "--profile", "full"]. The client must run as the same operating-system user and use the same Fluxmail data directory as setup. Stdio uses the local member session; it does not need an API key or a separate HTTP server. Ask the client to call list_accounts to check the connection. A fresh instance returns an empty account list. To deliver scheduled mail, keep fluxmail serve or fluxmail scheduled run running with the same data directory.

See Connect an MCP client for client configuration and HTTP connections. Its Cline section covers MCP settings and Cline CLI setup, also available as llms-install.md in this repository.

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, Business, and Enterprise 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.