Skip to content
MCP server

Fluxmail

Give AI agents scoped access to Gmail, Outlook and IMAP mailboxes

Runs locallyStatus and history
Pricing
Freemium
Platforms
self-hosted, CLI, API
Runs
Locally
Version
0.30.0
Listing updated
3 days ago

About Fluxmail

Fluxmail is a freemium MCP server for communication. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • GOOGLE_CLIENT_IDOptional override for Fluxmail's built-in Desktop OAuth client ID.
  • GOOGLE_CLIENT_SECRETClient secret paired with a custom Google OAuth client ID.
  • FLUXMAIL_DATA_DIRDirectory for the Fluxmail database, encryption key, and stored settings.
  • FLUXMAIL_LICENSE_KEYOptional Fluxmail license key for paid plan limits.

What it does

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

Pricing

Freemium, from $10 a month

Self-hosted Personal plan covers 3 mailboxes; Cloud Pro $120/yr, Business $240/member/yr, 7-day trial

Prices change. Check fluxmail.ai before you buy.

Fluxmail 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 to Fluxmail

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  5. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  6. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media