# Fluxmail

> Fluxmail is a freemium MCP server for communication. Give AI agents scoped access to Gmail, Outlook and IMAP mailboxes. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $10 a month
- **Platforms:** self-hosted, CLI, API, Web
- **Website:** https://fluxmail.ai
- **Repository:** https://github.com/fluxmailai/fluxmail/tree/HEAD/packages/server
- **MCP Registry name:** io.github.fluxmailai/fluxmail
- **Categories:** communication, productivity
- **Listing updated:** 2026-11-14

## About

Fluxmail separates what each agent may do with a mailbox: one agent can have read-only access while another may send, and either can be revoked from a dashboard. It covers Gmail, Google Workspace, Outlook, Microsoft 365, iCloud, Fastmail and any IMAP/SMTP account.

There are two ways to run it. Fluxmail Cloud is hosted and passes requests through to your provider without keeping a copy of your inbox. The self-hosted package (npm, Node.js 22.22 or newer, or Docker) keeps credentials in a local SQLite database and speaks MCP over stdio or HTTP, plus a REST API and CLI.

The source is available under the Elastic License 2.0. The README says the Personal plan supports three mailboxes and one member without a paid key, while Pro, Business and Enterprise entitlements need a licence key.

## Features

- **Per-agent permissions:** Choose read-only, draft or send rights for each agent and revoke them.
- **Multiple providers:** Gmail, Outlook, iCloud, Fastmail and any IMAP/SMTP mailbox.
- **Attachments and PDFs:** Agents can open attachments and read the text of PDFs.
- **Drafts and scheduled sends:** Save drafts for review or let the agent send.
- **MCP, REST and CLI:** Self-hosted installs expose all three interfaces.
- **Cloud or self-hosted:** Use the hosted service or run it yourself.

## Good for

- Summarize overnight email and list what needs a reply
- Pull vendors and totals from receipts for bookkeeping
- Find threads still waiting for an answer and draft reminders
- Archive old newsletters and label mail from the bank

## Install

### Claude Code (Terminal)

```sh
claude mcp add fluxmail --env GOOGLE_CLIENT_SECRET='<GOOGLE_CLIENT_SECRET>' --env FLUXMAIL_LICENSE_KEY='<FLUXMAIL_LICENSE_KEY>' -- npx -y fluxmail
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "fluxmail": {
      "command": "npx",
      "args": [
        "-y",
        "fluxmail"
      ],
      "env": {
        "GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
        "FLUXMAIL_LICENSE_KEY": "<FLUXMAIL_LICENSE_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "fluxmail": {
      "command": "npx",
      "args": [
        "-y",
        "fluxmail"
      ],
      "env": {
        "GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
        "FLUXMAIL_LICENSE_KEY": "<FLUXMAIL_LICENSE_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "fluxmail": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "fluxmail"
      ],
      "env": {
        "GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
        "FLUXMAIL_LICENSE_KEY": "<FLUXMAIL_LICENSE_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "fluxmail": {
      "command": "npx",
      "args": [
        "-y",
        "fluxmail"
      ],
      "env": {
        "GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
        "FLUXMAIL_LICENSE_KEY": "<FLUXMAIL_LICENSE_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "fluxmail": {
      "command": "npx",
      "args": [
        "-y",
        "fluxmail"
      ],
      "env": {
        "GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
        "FLUXMAIL_LICENSE_KEY": "<FLUXMAIL_LICENSE_KEY>"
      }
    }
  }
}
```

## FAQ

### Does Cloud store my email?

Per the pricing page, Cloud passes each request through to your provider and does not keep a copy of your inbox.

### What does Cloud cost?

Pro is $120 a year for one member and 10 mailboxes; Business is $240 per member a year. Plans start with a 7-day trial.

### Can I run it myself?

Yes, via the npm package or a Docker image; mail then stays with your provider and never passes through Fluxmail.

### What licence is the source under?

Elastic License 2.0, which is source available rather than OSI open source.

### Is Fluxmail free?

Fluxmail has a free plan, with paid plans for more usage or features. Paid plans start at $10 a month.

### How do I add Fluxmail to Claude Code?

Run this command in your terminal: claude mcp add fluxmail --env GOOGLE_CLIENT_SECRET='<GOOGLE_CLIENT_SECRET>' --env FLUXMAIL_LICENSE_KEY='<FLUXMAIL_LICENSE_KEY>' -- npx -y fluxmail

### What are the best alternatives to Fluxmail?

The closest alternatives to Fluxmail are Ha MCP, Concord MCP, note1, BoardAgent and Callout.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.

---
Source: https://ai-powered.com/mcp/fluxmail
