Fluxmail changelog

https://fluxmail.ai/llms.txt

− Fluxmail Cloud provides hosted MCP and REST access to existing mailboxes at cloud.fluxmail.ai. Cloud uses separate mailbox connections, OAuth authorization for MCP clients, and scoped agent keys for REST automation. Cloud documentation is at /docs/cloud, with a pasteable agent setup prompt at /docs/cloud/quickstart#agent-first-setup and a Cloud-only plain-text guide at /docs/cloud/llms.txt. Cloud offers Pro and Business subscriptions, a seven-day trial on a workspace's first subscription, and wo− - [Email for Codex](https://fluxmail.ai/integrations/codex): Connect Codex CLI or the Codex app to Gmail, Outlook, Exchange, or IMAP with a self-hosted MCP server. Set up with one command or a few lines of config.toml.− - [Email for Muse](https://fluxmail.ai/integrations/muse): Connect Muse to Gmail, Outlook, or IMAP with a Fluxmail Cloud custom connector. Sign in with OAuth and choose which mailboxes and actions Muse can use.− - [Configuration](https://fluxmail.ai/docs/configuration): Deployment configuration, encrypted instance settings, outbound proxies, local logging, secret files, and telemetry controls.− - [Connect IMAP/SMTP](https://fluxmail.ai/docs/connect-an-imap-mailbox): Connect any mailbox with IMAP and SMTP access, set its security options, and correct special-folder mappings.− - [Connect an MCP client](https://fluxmail.ai/docs/connect-an-mcp-client): Choose your MCP client, configure local or HTTP access, and verify the mailbox connection.− - [Connect Gmail / Google Workspace](https://fluxmail.ai/docs/connect-gmail-to-mcp): Connect a Gmail or Google Workspace mailbox, configure Google OAuth, and reconnect expired tokens.− - [Connect Outlook / Exchange](https://fluxmail.ai/docs/connect-outlook-to-mcp): Connect a Microsoft 365 or Outlook.com mailbox, or register your own Microsoft Entra application.− - [Deploy with Docker](https://fluxmail.ai/docs/deploy-with-docker): Run a persistent Fluxmail server, configure HTTPS, and verify a client connection.− - [Email search](https://fluxmail.ai/docs/email-search): Use the same portable search syntax with Fluxmail CLI, MCP, and REST clients.− - [Local logs](https://fluxmail.ai/docs/logging): Find and configure Fluxmail local logs without allowing unbounded disk use.− - [Fluxmail Self-Hosted](https://fluxmail.ai/docs/self-hosted): Connect your existing mailboxes to agents and apps with a Fluxmail server you control.− - [Permissions](https://fluxmail.ai/docs/permissions): Give each MCP or REST connection only the Fluxmail email permissions it needs.− - [Quickstart](https://fluxmail.ai/docs/quickstart): Install Fluxmail, connect a mailbox, and verify your first agent or CLI connection.− - [Send from another address](https://fluxmail.ai/docs/send-as-addresses): Use an existing Gmail, Outlook, or IMAP alias when you draft, reply, forward, send, or schedule a message.− - [Sending and retries](https://fluxmail.ai/docs/sending-and-retries): Preview a send, track its delivery, and retry without sending a duplicate.− - [Teams & plans](https://fluxmail.ai/docs/teams-and-plans): Add members, set mailbox access, and raise the limits on a self-hosted Fluxmail instance.− - [Telemetry](https://fluxmail.ai/docs/telemetry): Turn off anonymous telemetry and see what usage data and optional feedback Fluxmail sends.− - [Troubleshooting](https://fluxmail.ai/docs/troubleshooting): Fix common Fluxmail installation, mailbox connection, and authentication problems.− - [Upgrade Fluxmail](https://fluxmail.ai/docs/upgrade-fluxmail): Back up an installation, check client compatibility, and verify an upgrade.− - [Use the CLI](https://fluxmail.ai/docs/use-the-cli): Read and manage email, then configure the Fluxmail instance from the same command line.− - [fluxmail accounts access](https://fluxmail.ai/docs/cli/accounts-access): Set who can access a mailbox− - [fluxmail accounts assign](https://fluxmail.ai/docs/cli/accounts-assign): Change mailbox ownership− - [fluxmail emails forward](https://fluxmail.ai/docs/cli/emails-forward): Forward a message− - [fluxmail members remove](https://fluxmail.ai/docs/cli/members-remove): Remove a member after reassigning or removing their mailboxes− - [POST /api/v1/accounts/connections](https://fluxmail.ai/docs/rest-api/connect-own-account): Connect a Gmail, Outlook or IMAP mailbox, or reauthorize an existing mailbox you own or administer.− - [POST /api/v1/admin/api-keys](https://fluxmail.ai/docs/rest-api/create-administrative-api-key): Create an API key and return its plaintext secret once. Requires admin.api_keys.− - [POST /api/v1/admin/connections](https://fluxmail.ai/docs/rest-api/create-administrative-connection): Create or reauthorize a Gmail, Outlook, or IMAP connection. Requires admin.accounts.− - [DELETE /api/v1/admin/members/{memberId}](https://fluxmail.ai/docs/rest-api/delete-member): Remove a member after reassigning or removing their mailboxes. Requires admin.members.− - [POST /api/v1/accounts/{accountId}/messages/{messageId}/forward](https://fluxmail.ai/docs/rest-api/forward-message): Forward a message to one or more recipients.− - [PATCH /api/v1/admin/accounts/{accountId}](https://fluxmail.ai/docs/rest-api/update-account-access): Change mailbox ownership, instance-wide sharing or member grants. Requires admin.accounts.− - [Upgrade to 0.11.0](https://fluxmail.ai/docs/upgrades/0.11.0): Update send, bulk modify, MCP, and CLI clients for the new delivery contracts.− - [Upgrade to 0.14.0](https://fluxmail.ai/docs/upgrades/0.14.0): Choose permissions for stdio clients and new API keys, restore permanent deletion, and read inline attachment content.− - [Upgrade to 0.15.0](https://fluxmail.ai/docs/upgrades/0.15.0): Move to Node.js 22.22 or later before installing Fluxmail 0.15.0.− - [Upgrade to 0.17.0](https://fluxmail.ai/docs/upgrades/0.17.0): Update custom MCP error handling and HTTP response parsing, and back up the store before upgrading.− - [Upgrade to 0.19.0](https://fluxmail.ai/docs/upgrades/0.19.0): Keep MCP arguments within published input limits and normalize date filters before calling tools.− - [Upgrade from 0.4 to 0.5](https://fluxmail.ai/docs/upgrades/0.5.0): Migrate an existing Fluxmail 0.4.x instance to member authentication in Fluxmail 0.5.0.− - [Upgrade to 0.6.0](https://fluxmail.ai/docs/upgrades/0.6.0): Migrate plaintext configuration to typed deployment configuration and encrypted instance settings.− - [Upgrade to 0.7.0](https://fluxmail.ai/docs/upgrades/0.7.0): Migrate search filters, typed search strings, provider capabilities, and page tokens.− - [Upgrade to 0.9.0](https://fluxmail.ai/docs/upgrades/0.9.0): Prepare stored data and custom email providers for Fluxmail 0.9.0.+ Fluxmail Cloud provides hosted MCP and REST access to existing mailboxes at cloud.fluxmail.ai. Cloud uses separate mailbox connections, OAuth authorization for MCP clients, and scoped agent keys for REST automation. Cloud documentation is at /docs/cloud, with a pasteable agent setup prompt at /docs/cloud/quickstart#agent-first-setup and a Cloud-only plain-text guide at /docs/cloud/llms.txt. Cloud offers Pro and Business subscriptions and a seven-day trial on a workspace's first subscription. Bus+ - [Email for Codex](https://fluxmail.ai/integrations/codex): Add Fluxmail to Codex CLI or the Codex app to search, read, draft, and send email in Gmail, Outlook, Exchange, or IMAP. Self-hosted, with permissions you choose.+ - [Email for Meta Muse](https://fluxmail.ai/integrations/muse): Connect Meta Muse to Gmail, Outlook, or IMAP with a Fluxmail Cloud custom connector. Sign in with OAuth and choose which mailboxes and actions Muse can use.+ - [fluxmail accounts access](https://fluxmail.ai/docs/cli/accounts-access): Set who can access a mailbox you own+ - [fluxmail accounts assign](https://fluxmail.ai/docs/cli/accounts-assign): Hand a mailbox you own to another member+ - [fluxmail emails forward](https://fluxmail.ai/docs/cli/emails-forward): Forward or schedule a forward of a message+ - [fluxmail members remove](https://fluxmail.ai/docs/cli/members-remove): Remove a member, handing their mailboxes to another member+ - [Configuration](https://fluxmail.ai/docs/configuration): Deployment configuration, encrypted instance settings, outbound proxies, local logging, secret files, and telemetry controls.+ - [Connect IMAP/SMTP](https://fluxmail.ai/docs/connect-an-imap-mailbox): Connect any mailbox with IMAP and SMTP access, set its security options, and correct special-folder mappings.+ - [Connect an MCP client](https://fluxmail.ai/docs/connect-an-mcp-client): Choose your MCP client, configure local or HTTP access, and verify the mailbox connection.+ - [Connect Gmail / Google Workspace](https://fluxmail.ai/docs/connect-gmail-to-mcp): Connect a Gmail or Google Workspace mailbox, configure Google OAuth, and reconnect expired tokens.+ - [Connect Outlook / Exchange](https://fluxmail.ai/docs/connect-outlook-to-mcp): Connect a Microsoft 365 or Outlook.com mailbox, or register your own Microsoft Entra application.+ - [Deploy with Docker](https://fluxmail.ai/docs/deploy-with-docker): Run a persistent Fluxmail server, configure HTTPS, and verify a client connection.+ - [Email search](https://fluxmail.ai/docs/email-search): Use the same portable search syntax with Fluxmail CLI, MCP, and REST clients.+ - [Local logs](https://fluxmail.ai/docs/logging): Find and configure Fluxmail local logs without allowing unbounded disk use.+ - [Fluxmail Self-Hosted](https://fluxmail.ai/docs/self-hosted): Connect your existing mailboxes to agents and apps with a Fluxmail server you control.+ - [Permissions](https://fluxmail.ai/docs/permissions): Give each MCP or REST connection only the Fluxmail email permissions it needs.+ - [Quickstart](https://fluxmail.ai/docs/quickstart): Install Fluxmail, connect a mailbox, and verify your first agent or CLI connection.+ - [POST /api/v1/accounts/connections](https://fluxmail.ai/docs/rest-api/connect-own-account): Connect a Gmail, Outlook or IMAP mailbox, or reauthorize a mailbox you own.+ - [POST /api/v1/admin/api-keys](https://fluxmail.ai/docs/rest-api/create-administrative-api-key): Create an API key and return its plaintext secret once. A key you create for another member reaches only mailboxes you both can read. Requires admin.api_keys.+ - [POST /api/v1/admin/connections](https://fluxmail.ai/docs/rest-api/create-administrative-connection): Connect a Gmail, Outlook, or IMAP mailbox for any active or invited member, or reauthorize a mailbox you own. Requires admin.accounts.+ - [DELETE /api/v1/admin/members/{memberId}](https://fluxmail.ai/docs/rest-api/delete-member): Remove a member permanently. Their mailboxes go to the member named in reassignTo; without it, they must own no mailboxes. Their API keys, and keys they created for others, are revoked. Requires admin.members.+ - [POST /api/v1/accounts/{accountId}/messages/{messageId}/forward](https://fluxmail.ai/docs/rest-api/forward-message): Forward a message to one or more recipients now, or schedule the forward for a specified time.+ - [PATCH /api/v1/admin/accounts/{accountId}](https://fluxmail.ai/docs/rest-api/update-account-access): Change ownership or sharing of a mailbox you own. Requires admin.accounts. To move another member's mailboxes, remove the member with a new owner for their mailboxes.+ - [PATCH /api/v1/accounts/{accountId}/access](https://fluxmail.ai/docs/rest-api/update-own-account-access): Share a mailbox you own with every member or with selected members, make it private, or hand it to another member.+ - [Send from another address](https://fluxmail.ai/docs/send-as-addresses): Use an existing Gmail, Outlook, or IMAP alias when you draft, reply, forward, send, or schedule a message.+ - [Sending and retries](https://fluxmail.ai/docs/sending-and-retries): Preview a send, track its delivery, and retry without sending a duplicate.+ - [Teams & plans](https://fluxmail.ai/docs/teams-and-plans): Add members, set mailbox access, and raise the limits on a self-hosted Fluxmail instance.+ - [Telemetry](https://fluxmail.ai/docs/telemetry): Turn off anonymous telemetry and see what usage data and optional feedback Fluxmail sends.+ - [cancel_scheduled_email](https://fluxmail.ai/docs/tools/cancel-scheduled-email): Cancel a pending scheduled send by its scheduleId. The draft stays in the Drafts folder, so the content is not lost. Get the scheduleId from send_email or forward_email with sendAt, or from list_scheduled_emails.+ - [forward_email](https://fluxmail.ai/docs/tools/forward-email): Forward an email to new recipients with a "Fwd:" subject and the quoted original. The original attachments are included unless includeAttachments is false, and an optional comment appears above the forwarded content. Repeating a successful forward with the same idempotencyKey and arguments returns the saved result instead of sending again. Add sendAt to schedule the forward instead of sending it now. Scheduled mail is delivered by + - [list_emails_batch](https://fluxmail.ai/docs/tools/list-emails-batch): List or search emails in up to 20 accounts at once, with one result group per account. Filter with query, which takes typed search such as from:ann@example.com is:unread, and use folder for a folder role. Each account pages with its own pageToken.+ - [list_emails](https://fluxmail.ai/docs/tools/list-emails): List or search emails in a mailbox, with metadata and optional previews. Filter with query, which takes typed search such as from:ann@example.com is:unread after:2026-01-01, and use folder for custom folders and labels. Paginate with pageToken. Use get_email for full bodies.+ - [list_scheduled_emails](https://fluxmail.ai/docs/tools/list-scheduled-emails): List scheduled sends: pending ones first, with sendAt, then past ones that were sent, failed or canceled. For failed entries, lastError says what went wrong. Pending sends only fire while the Fluxmail server is running.+ - [search_emails_batch](https://fluxmail.ai/docs/tools/search-emails-batch): Another name for `list_emails_batch`, with the same arguments, permissions and results.+ - [search_emails](https://fluxmail.ai/docs/tools/search-emails): Another name for `list_emails`, with the same arguments, permissions and results.+ - [send_email](https://fluxmail.ai/docs/tools/send-email): Send an email from a connected mailbox. There are three modes: direct (to, subject and body), an existing draft (draftId), or a reply (replyToMessageId, optionally with replyAll) that takes its recipients, subject and threading from the original and quotes it below the body unless quoteOriginal is false. Repeating a successful send with the same idempotencyKey and arguments returns the saved result instead of sending again. Reusing a key+ - [Troubleshooting](https://fluxmail.ai/docs/troubleshooting): Fix common Fluxmail installation, mailbox connection, and authentication problems.+ - [Upgrade Fluxmail](https://fluxmail.ai/docs/upgrade-fluxmail): Back up an installation, check client compatibility, and verify an upgrade.+ - [Upgrade to 0.11.0](https://fluxmail.ai/docs/upgrades/0.11.0): Update send, bulk modify, MCP, and CLI clients for the new delivery contracts.

Showing the first 40 of each.

version

0.26.0 → 0.27.0

version

0.25.0 → 0.26.0

version

0.24.0 → 0.25.0

version

0.23.0 → 0.24.0

https://raw.githubusercontent.com/fluxmailai/fluxmail/HEAD/AGENTS.md

− - Put developer-facing documentation under `docs/`, outside `docs/public/`, when the repository needs it.− - Update handwritten user documentation only when a change makes existing guidance inaccurate or leaves users without instructions they need to install, configure, or use Fluxmail. Before editing, identify the incorrect statement or missing user action. If neither exists, leave the documentation alone.− Cloud's tool contract is `services/cloud/src/__tests__/fixtures/mcp-contract.json` in fluxmail-web. Read it with `gh api repos/fluxmailai/fluxmail-web/contents/services/cloud/src/__tests__/fixtures/mcp-contract.json --jq .content | base64 --decode`, or ask the user if you don't have access.− Don't edit fluxmail-web from here. In the final report, say whether Cloud needs a matching change or a `@fluxmail/core` version bump. If it does, write a self-contained prompt for an agent in fluxmail-web, include it in the report, and state the target behavior with tool names, schemas, annotations and scopes.+ - Focus public documentation on what users can do, how to do it, and the permissions, limits, and privacy details that affect them. Name third-party tools we use, or describe internal routing, architecture and implementation, only when users need that information to configure, use or troubleshoot Fluxmail or understand how their data is handled. Otherwise describe the user-visible behavior and refer to Fluxmail. Keep support pipelines and release coordination in developer documentation.+ - During copy and code reviews, flag unnecessary vendor names and internal implementation details in public docs, UI text, tool descriptions and generated content. Keep vendor names for feedback processing in the website privacy policy's service-provider list; use generic wording in feedback instructions and retention explanations, linking to the privacy policy when needed. Preserve disclosures about data sharing, retention and deletion.+ - Preserve the operational details people need to run their own server, including deployment, backups, credential management, scheduling, and upgrades.+ - Put developer-facing documentation under `docs/`, outside `docs/public/`, when the repository needs it. Update architecture docs and runbooks only when a lasting change affects system boundaries or how developers and operators maintain the service. Keep implementation narratives, test reports, and change histories in PR descriptions or development artifacts.+ - Make the smallest necessary documentation change. Update handwritten user documentation only when a change makes existing guidance inaccurate or leaves users without instructions they need to install, configure, or use Fluxmail. Before editing, identify the incorrect statement or missing user action. If neither exists, leave the documentation alone.+ - Apply the same audience and relevance rules to generated documentation. Keep page summaries concise and document the arguments, permissions, and behavior users need. Fix the generator or its source metadata; do not hand-edit generated output or weaken MCP agent instructions to shorten a public page.+ - Approved exception: MCP connection and operation events may include the client's self-reported name and version as `mcp_client_name` and `mcp_client_version`, using the trimming and length limits in `packages/core/src/mcp/clients.ts` (128 and 64 characters). These fields intentionally retain arbitrary client text, even when it resembles an email address, identifier, or file path. Do not flag this collection as a privacy violation or require additional filtering. This exception applies only to + The shared contract is `@fluxmail/core/mcp` (`packages/core/src/mcp/`); see `docs/mcp-tool-contract.md`. Cloud's tool snapshot is `services/cloud/src/__tests__/fixtures/mcp-contract.json` in fluxmail-web. Read it with `gh api repos/fluxmailai/fluxmail-web/contents/services/cloud/src/__tests__/fixtures/mcp-contract.json --jq .content | base64 --decode`, or ask the user if you don't have access.+ When Cloud needs a matching change, make it in a separate checkout or worktree and follow that repository's instructions. Preserve existing work in both repositories. In the final report, identify the changes in each repository and whether Cloud needs an `@fluxmail/core` dependency bump. If the matching change cannot be completed, save a self-contained handoff prompt with the target behavior, tool names, schemas, annotations and scopes, and link it in the report.+ # Parallel sessions+ Other sessions may be using the main checkout, so don't switch its branch, stash its changes or edit its files. Do each task in its own worktree: start Claude with `claude --worktree <name>`, or call `EnterWorktree` before you change anything. The hooks in `.claude/settings.json` install dependencies in a new worktree and give it its own `FLUXMAIL_DATA_DIR` and demo mailbox settings: `FLUXMAIL_DEMO_PROJECT` and the `FLUXMAIL_DEMO_*_PORT` variables. Every Bash command in the worktree gets them. T+ Rex tabs and panes start from your login shell, so a server you start in one doesn't get these variables. Load them in the command, for example `rex window new -s "$REX_SESSION" Server -c "$PWD" --keep-open --focus=false -- sh -c 'eval "$(bash scripts/worktree-setup.sh --env "$PWD")" && exec pnpm dev'`.+ # Verifying changes+ Before reporting a change as finished, run it and confirm it works. Passing tests and type checks don't show that a command prints the right output, a tool returns the right result, or a fix solves the reported problem.+ - Reproduce a bug before fixing it, then repeat the same steps after the fix.+ - For a user-facing change to the CLI, MCP tools, REST API or OAuth pages, capture the behavior before and after it. Run the published release with `pnpm demo:setup -- --version <version>` and `pnpm demo:run -- --version <version> ...` for the before case, and the workspace build for the after case. See `docs/demo-mailbox.md`.+ - For a new feature, capture every case a user can reach: the main path, empty results, invalid input, missing permissions, and provider errors.+ - Save the command output, or the MCP or REST request and response, for each case. Record browser pages, such as OAuth pages, as video with `agent-browser record start <path> <url>` and `agent-browser record stop`. Save everything under `.context/verification/` and don't commit it.+ - Verify against the demo mailbox or another synthetic mailbox. Never send mail from, or change, a real account to verify a change.+ - In the final report, say what you checked and how, link each capture, and list anything you couldn't verify and why, such as provider behavior that needs a real Gmail or Outlook account.+ # Commit messages+ Use Conventional Commits for commit messages and PR titles: `type(scope): description`. The scope is optional. Use `feat` for features, `fix` for bug fixes, and `docs`, `refactor`, `perf`, `test`, `build`, `ci`, `chore`, `style`, or `revert` as appropriate. Write a short, imperative description, such as `fix(cloud): handle Gmail timeouts`. Mark breaking changes with `!` before the colon, such as `feat(api)!: require a mailbox ID`.

version

0.22.0 → 0.23.0

https://fluxmail.ai/llms.txt

− - Self-hosted server: Fluxmail packages its CLI, MCP server, and REST API in the `fluxmail` npm package (Node.js 20.20.x or 22.22+) and a Docker image, with source available on GitHub.− - [Compare](https://fluxmail.ai/compare): Best email MCP servers and APIs for AI agents, plus Fluxmail compared with each one− - [Fluxmail vs AgentMail](https://fluxmail.ai/compare/agentmail): Compare Fluxmail and AgentMail as an email API for AI agents: new agent inboxes or your existing mailboxes, MCP, REST, webhooks, permissions, and pricing.− - [Fluxmail vs EmailEngine](https://fluxmail.ai/compare/emailengine): Compare Fluxmail and EmailEngine on MCP, REST, webhooks, providers, permissions, deployment, and pricing for self-hosted email infrastructure.− - [Fluxmail vs Gmail MCP Server](https://fluxmail.ai/compare/gmail-mcp): Compare Gmail MCP pricing, personal Gmail access, and setup. Fluxmail has a free self-hosted plan; Google's server requires Workspace preview enrollment.− - [Fluxmail vs ChatGPT Gmail](https://fluxmail.ai/compare/chatgpt-gmail): Compare Fluxmail with the ChatGPT Gmail app on setup, email actions, providers, privacy, MCP access, and the best fit for your workflow.− - [Fluxmail vs Claude Gmail](https://fluxmail.ai/compare/claude-gmail): Compare Claude's built-in Gmail integration with Fluxmail on attachments, scheduling, Outlook and IMAP support, and setup, and see when the built-in one is enough.− - [Fluxmail vs Composio Gmail](https://fluxmail.ai/compare/composio-gmail): Compare Fluxmail and Composio Gmail on MCP hosting, OAuth, email tools, providers, permissions, pricing, and multi-app agent workflows.− - [Architecture](https://fluxmail.ai/docs/architecture): Where Fluxmail keeps your data and how MCP, REST, and CLI requests reach each email provider.− - [Authentication and instances](https://fluxmail.ai/docs/authentication-and-instances): Log in to local and remote Fluxmail instances, enroll members, manage sessions, connect MCP clients with OAuth, and create API keys.− - [Connect Outlook / Exchange](https://fluxmail.ai/docs/connect-outlook-to-mcp): Register a Microsoft Entra application for Microsoft 365 or Outlook.com.− - [Telemetry](https://fluxmail.ai/docs/telemetry): See what usage data Fluxmail sends and how to turn it off.− - [fluxmail login](https://fluxmail.ai/docs/cli/login): Log in to a local or remote instance− - [Activate a license](https://fluxmail.ai/docs/rest-api/activate-administrative-license): Validate and activate a Fluxmail license key. Requires admin.license.− - [Cancel a scheduled send](https://fluxmail.ai/docs/rest-api/cancel-scheduled-send): Cancel a pending scheduled send and keep its provider draft.− - [Change the current member password](https://fluxmail.ai/docs/rest-api/change-password): Reference for PUT /api/v1/me/password.− - [Connect or reauthorize a mailbox account](https://fluxmail.ai/docs/rest-api/connect-own-account): Reference for POST /api/v1/accounts/connections.− - [Create an API key](https://fluxmail.ai/docs/rest-api/create-administrative-api-key): Create an API key and return its plaintext secret once. Requires admin.api_keys.− - [Create or reauthorize a connection](https://fluxmail.ai/docs/rest-api/create-administrative-connection): Create or reauthorize a Gmail, Outlook, or IMAP connection. Requires admin.accounts.− - [Create a draft](https://fluxmail.ai/docs/rest-api/create-draft): Create a new draft or a reply draft in an email account.− - [Issue a member password reset](https://fluxmail.ai/docs/rest-api/create-member-password-reset): Reference for POST /api/v1/admin/members/{memberId}/password-reset.− - [Create and invite a member](https://fluxmail.ai/docs/rest-api/create-member): Reference for POST /api/v1/admin/members.− - [Create an API key for the current member](https://fluxmail.ai/docs/rest-api/create-own-api-key): Reference for POST /api/v1/me/api-keys.− - [Deactivate a license](https://fluxmail.ai/docs/rest-api/deactivate-administrative-license): Release the stored license and return this instance to Personal limits. Requires admin.license.− - [Remove a mailbox account](https://fluxmail.ai/docs/rest-api/delete-admin-account): Reference for DELETE /api/v1/admin/accounts/{accountId}.− - [Reset an OAuth application](https://fluxmail.ai/docs/rest-api/delete-administrative-oauth-app): Remove a stored OAuth application. Requires admin.accounts.− - [Delete a draft](https://fluxmail.ai/docs/rest-api/delete-draft): Delete an existing draft from an email account.− - [Remove a member](https://fluxmail.ai/docs/rest-api/delete-member): Reference for DELETE /api/v1/admin/members/{memberId}.− - [Download an attachment](https://fluxmail.ai/docs/rest-api/download-attachment): Download one attachment as raw bytes.− - [Enroll a member](https://fluxmail.ai/docs/rest-api/enroll-member): Reference for POST /api/v1/auth/enroll.− - [Forward a message](https://fluxmail.ai/docs/rest-api/forward-message): Forward a message to one or more recipients.− - [Get license status](https://fluxmail.ai/docs/rest-api/get-administrative-license): Get license status and usage without returning the configured license key. Requires admin.license.− - [Get OAuth application status](https://fluxmail.ai/docs/rest-api/get-administrative-oauth-apps): Get safe OAuth application metadata without returning client secrets. Requires admin.accounts.− - [Get API information](https://fluxmail.ai/docs/rest-api/get-api-info): Return the Fluxmail version and the URL of the OpenAPI document.− - [Get the authenticated member](https://fluxmail.ai/docs/rest-api/get-current-member): Reference for GET /api/v1/me.− - [Get a delivery outcome](https://fluxmail.ai/docs/rest-api/get-delivery-operation): Reference for GET /api/v1/accounts/{accountId}/delivery-operations/{operationId}.− - [Get a draft](https://fluxmail.ai/docs/rest-api/get-draft): Reference for GET /api/v1/accounts/{accountId}/drafts/{draftId}.− - [Get a message](https://fluxmail.ai/docs/rest-api/get-message): Get one message by its provider ID.− - [Get server status](https://fluxmail.ai/docs/rest-api/get-status): Return provider and mailbox status for the accounts available to the API key.− - [Get a thread](https://fluxmail.ai/docs/rest-api/get-thread): Get a complete email thread by its provider ID.+ - Self-hosted server: Fluxmail packages its CLI, MCP server, and REST API in the `fluxmail` npm package (Node.js 22.22 or newer) and a Docker image, with source available on GitHub.+ - [Compare](https://fluxmail.ai/compare): Fluxmail compared with other email MCP servers and APIs for AI agents+ - [Fluxmail vs AgentMail](https://fluxmail.ai/compare/agentmail): AgentMail gives each agent a new inbox. Fluxmail connects agents to the Gmail, Outlook, and IMAP mailboxes you already use. Compare MCP, inbound events, and pricing.+ - [Fluxmail vs EmailEngine](https://fluxmail.ai/compare/emailengine): Fluxmail and EmailEngine are self-hosted email APIs that connect AI agents to Gmail, Outlook, and IMAP. Compare MCP support, setup, storage, webhooks, and pricing.+ - [Fluxmail vs Gmail MCP Server](https://fluxmail.ai/compare/gmail-mcp): Google's Gmail MCP server is a Workspace developer preview. Fluxmail works with personal Gmail, Outlook, and IMAP, hosted or on a free self-hosted plan.+ - [Fluxmail vs ChatGPT Gmail](https://fluxmail.ai/compare/chatgpt-gmail): Compare Fluxmail with the Gmail plugin for ChatGPT on setup, email actions, providers, privacy, MCP access, and which one fits your workflow.+ - [Fluxmail vs Claude Gmail](https://fluxmail.ai/compare/claude-gmail): Claude's Gmail connector can see attachment details but can't download the files. Compare it with Fluxmail on attachments, Outlook and IMAP support, and setup.+ - [Fluxmail vs Composio Gmail](https://fluxmail.ai/compare/composio-gmail): Composio hosts Gmail over MCP next to many other apps, and Fluxmail covers email across Gmail, Outlook, and IMAP. Compare OAuth, tools, permissions, and price.+ - [Architecture](https://fluxmail.ai/docs/architecture): Understand local storage, mailbox access, provider differences, and the data your MCP client receives.+ - [Authentication and instances](https://fluxmail.ai/docs/authentication-and-instances): Log in to local and remote Fluxmail instances or Fluxmail Cloud, enroll members, manage sessions, connect MCP clients with OAuth, and create API keys.+ - [Connect Outlook / Exchange](https://fluxmail.ai/docs/connect-outlook-to-mcp): Connect a Microsoft 365 or Outlook.com mailbox, or register your own Microsoft Entra application.+ - [Telemetry](https://fluxmail.ai/docs/telemetry): Turn off anonymous telemetry and see what usage data and optional feedback Fluxmail sends.+ - [fluxmail login](https://fluxmail.ai/docs/cli/login): Log in to a local or remote instance, or to Fluxmail Cloud+ - [POST /api/v1/admin/license/activate](https://fluxmail.ai/docs/rest-api/activate-administrative-license): Validate and activate a Fluxmail license key. Requires admin.license.+ - [DELETE /api/v1/accounts/{accountId}/scheduled-sends/{scheduleId}](https://fluxmail.ai/docs/rest-api/cancel-scheduled-send): Cancel a pending scheduled send and keep its provider draft.+ - [PUT /api/v1/me/password](https://fluxmail.ai/docs/rest-api/change-password): Change your password and revoke your other sessions and OAuth connections.+ - [POST /api/v1/accounts/connections](https://fluxmail.ai/docs/rest-api/connect-own-account): Connect a Gmail, Outlook or IMAP mailbox, or reauthorize an existing mailbox you own or administer.+ - [POST /api/v1/admin/api-keys](https://fluxmail.ai/docs/rest-api/create-administrative-api-key): Create an API key and return its plaintext secret once. Requires admin.api_keys.+ - [POST /api/v1/admin/connections](https://fluxmail.ai/docs/rest-api/create-administrative-connection): Create or reauthorize a Gmail, Outlook, or IMAP connection. Requires admin.accounts.+ - [POST /api/v1/accounts/{accountId}/drafts](https://fluxmail.ai/docs/rest-api/create-draft): Create a new draft or a reply draft in an email account.+ - [POST /api/v1/admin/members/{memberId}/password-reset](https://fluxmail.ai/docs/rest-api/create-member-password-reset): Issue a one-time password reset code for a member. Requires admin.members.+ - [POST /api/v1/admin/members](https://fluxmail.ai/docs/rest-api/create-member): Create a pending member and return a one-time enrollment code. Requires admin.members.+ - [POST /api/v1/me/api-keys](https://fluxmail.ai/docs/rest-api/create-own-api-key): Create an API key for yourself and return its secret once.+ - [DELETE /api/v1/admin/license](https://fluxmail.ai/docs/rest-api/deactivate-administrative-license): Release the stored license and return this instance to Personal limits. Requires admin.license.+ - [DELETE /api/v1/admin/accounts/{accountId}](https://fluxmail.ai/docs/rest-api/delete-admin-account): Disconnect a mailbox and remove its stored credentials. Requires admin.accounts.+ - [DELETE /api/v1/admin/oauth-apps/{provider}](https://fluxmail.ai/docs/rest-api/delete-administrative-oauth-app): Remove a stored OAuth application. Requires admin.accounts.+ - [DELETE /api/v1/accounts/{accountId}/drafts/{draftId}](https://fluxmail.ai/docs/rest-api/delete-draft): Delete an existing draft from an email account.+ - [DELETE /api/v1/admin/members/{memberId}](https://fluxmail.ai/docs/rest-api/delete-member): Remove a member after reassigning or removing their mailboxes. Requires admin.members.+ - [GET /api/v1/accounts/{accountId}/messages/{messageId}/attachments/{attachmentId}](https://fluxmail.ai/docs/rest-api/download-attachment): Download one attachment as raw bytes.+ - [POST /api/v1/auth/enroll](https://fluxmail.ai/docs/rest-api/enroll-member): Set your first password with an enrollment code and receive a member session.+ - [POST /api/v1/accounts/{accountId}/messages/{messageId}/forward](https://fluxmail.ai/docs/rest-api/forward-message): Forward a message to one or more recipients.+ - [GET /api/v1/admin/license](https://fluxmail.ai/docs/rest-api/get-administrative-license): Get license status and usage without returning the configured license key. Requires admin.license.+ - [GET /api/v1/admin/oauth-apps](https://fluxmail.ai/docs/rest-api/get-administrative-oauth-apps): Get safe OAuth application metadata without returning client secrets. Requires admin.accounts.+ - [GET /api/v1](https://fluxmail.ai/docs/rest-api/get-api-info): Return the Fluxmail version and the URL of the OpenAPI document.+ - [GET /api/v1/me](https://fluxmail.ai/docs/rest-api/get-current-member): Get the name, role and status of the authenticated member.+ - [GET /api/v1/accounts/{accountId}/delivery-operations/{operationId}](https://fluxmail.ai/docs/rest-api/get-delivery-operation): Check whether a send or forward succeeded, failed or has an uncertain outcome. Requires mail.send.+ - [GET /api/v1/accounts/{accountId}/drafts/{draftId}](https://fluxmail.ai/docs/rest-api/get-draft): Read an existing draft by its provider ID. Requires mail.drafts.+ - [GET /api/v1/accounts/{accountId}/messages/{messageId}](https://fluxmail.ai/docs/rest-api/get-message): Get one message by its provider ID.+ - [GET /api/v1/status](https://fluxmail.ai/docs/rest-api/get-status): Return provider and mailbox status for the accounts available to the API key.+ - [GET /api/v1/accounts/{accountId}/threads/{threadId}](https://fluxmail.ai/docs/rest-api/get-thread): Get a complete email thread by its provider ID.

Showing the first 40 of each.

version

0.19.0 → 0.22.0

version

0.18.0 → 0.19.0

version

0.17.1 → 0.18.0

version

0.17.0 → 0.17.1

version

0.16.0 → 0.17.0

https://raw.githubusercontent.com/fluxmailai/fluxmail/HEAD/AGENTS.md

+ # Writing style+ - When writing or editing copy that will be committed, published, displayed by a product, or sent to another person (such as READMEs, docs, marketing or landing pages, CLI output, error messages, UI strings, and emails), apply the [humanizer skill](.agents/skills/humanizer/SKILL.md) to remove AI writing patterns.+ - Do not invoke the humanizer skill for ordinary assistant conversation, technical explanations, status updates, code review findings, or other responses that exist only in the current chat.+ # Cloud parity+ Fluxmail Cloud (`services/cloud` in the private fluxmailai/fluxmail-web repository) shares mail scope names, permission presets and per-tool scope requirements with this repository. Tools both products offer use the same names, arguments, annotations and behavior. Cloud also runs this repository's provider adapters through a pinned `@fluxmail/core` version.+ When a change touches any of these, check Cloud before finishing:+ - MCP tool names, input schemas, annotations, descriptions or error semantics+ - mail scopes, presets, or which scope a tool or action needs+ - `@fluxmail/core` provider behavior or exports+ Cloud's tool contract is `services/cloud/src/__tests__/fixtures/mcp-contract.json` in fluxmail-web. Read it with `gh api repos/fluxmailai/fluxmail-web/contents/services/cloud/src/__tests__/fixtures/mcp-contract.json --jq .content | base64 --decode`, or ask the user if you don't have access.+ Don't edit fluxmail-web from here. In the final report, say whether Cloud needs a matching change or a `@fluxmail/core` version bump. If it does, write a self-contained prompt for an agent in fluxmail-web, include it in the report, and state the target behavior with tool names, schemas, annotations and scopes.+ Only this repository offers scheduled sending (`list_scheduled_emails`, `cancel_scheduled_email` and `send_email`'s `sendAt` argument). This repository's `get_status` corresponds to Cloud's `get_connection_status`. Only mention these differences when a change widens or narrows them.

https://fluxmail.ai/llms.txt

− > Self-hosted email infrastructure for agents and apps. Access your Gmail, Outlook, Exchange, and IMAP email accounts through MCP, REST API, or CLI.− Fluxmail is self-hosted email infrastructure for agents and apps. It connects Gmail, Outlook, Exchange, and IMAP mailboxes through MCP, a versioned REST API, and a CLI. All three interfaces can search, read, draft, send, schedule, and organize email. AI agents can connect over local stdio or Streamable HTTP, while apps and backend workflows can use REST. The CLI includes Fluxmail-managed Gmail OAuth and also accepts custom Google credentials. Fluxmail encrypts provider credentials in local stora− - [Home](https://fluxmail.ai/): Self-hosted email infrastructure for agents and apps, available through MCP, REST API, and CLI− - [Integrations](https://fluxmail.ai/integrations): Setup guides for Claude Code, Codex, Cursor, and other MCP clients− - [Compare](https://fluxmail.ai/compare): Fluxmail compared with other email MCP servers, connectors, and email APIs− - [Fluxmail vs Gmail MCP Server](https://fluxmail.ai/compare/gmail-mcp): Compare Gmail MCP pricing, personal Gmail access, and setup. Fluxmail has a free self-hosted plan; Google's server requires Workspace preview enrollment.− - [Fluxmail vs Work IQ MCP](https://fluxmail.ai/compare/outlook-mcp): Looking for an Outlook MCP server? Compare Fluxmail and Microsoft's Work IQ MCP on hosting, providers, email tools, permissions, setup, and cost.− - [Fluxmail vs Claude Gmail](https://fluxmail.ai/compare/claude-gmail): Compare Claude's built-in Gmail integration with Fluxmail on sending, attachments, Outlook and IMAP support, and setup, and see when the built-in one is enough.− - [Authentication and instances](https://fluxmail.ai/docs/authentication-and-instances): Log in to local and remote Fluxmail instances, enroll members, manage sessions, and create API keys.− - [Cancel scheduled email](https://fluxmail.ai/docs/tools/cancel-scheduled-email): Cancel a pending scheduled send by scheduleId (from send_email with sendAt, or list_scheduled_emails). The draft stays in the Drafts folder, so the content is not lost.− - [Create draft](https://fluxmail.ai/docs/tools/create-draft): Create a draft. For a reply draft, pass replyToMessageId (recipients/subject are derived; replyAll for reply-all).− - [Delete draft](https://fluxmail.ai/docs/tools/delete-draft): Delete a draft.− - [Download attachment](https://fluxmail.ai/docs/tools/download-attachment): Get metadata and a resource link for one attachment, up to 10 MB. With inline, the result also includes the content. For a PDF, inline adds extracted text, and pages returns the text of a page range such as 201-400.− - [Forward email](https://fluxmail.ai/docs/tools/forward-email): Forward an email to new recipients: quoted original body, "Fwd:" subject, original attachments included unless includeAttachments=false. Optional comment appears above the forwarded content.− - [Get delivery operation](https://fluxmail.ai/docs/tools/get-delivery-operation): Check whether a send or forward succeeded, failed, or has an uncertain outcome.− - [Get draft](https://fluxmail.ai/docs/tools/get-draft): Read an existing draft by its draft ID.− - [Get email body](https://fluxmail.ai/docs/tools/get-email-body): Read a bounded portion of one email body. Use nextOffset to continue.− - [Get email](https://fluxmail.ai/docs/tools/get-email): Fetch one email in full: body (text and/or HTML), recipients, attachment metadata.− - [Get status](https://fluxmail.ai/docs/tools/get-status): Account connection and scheduled-send status, including accounts that need re-authentication. Administrators also see plan details.− - [Get thread](https://fluxmail.ai/docs/tools/get-thread): Fetch a page of conversation messages with bounded body content.− - [MCP tools](https://fluxmail.ai/docs/tools): Use Fluxmail MCP tools to read, search, draft, send, schedule, and organize email.− - [List accounts](https://fluxmail.ai/docs/tools/list-accounts): List connected email accounts (id, provider, email, status, capabilities).− - [List emails](https://fluxmail.ai/docs/tools/list-emails): List emails from the user's connected mailbox with metadata and optional previews. Filter by folder, sender, unread, dates, etc. Paginate with pageToken. Use get_email for full bodies.− - [List folders](https://fluxmail.ai/docs/tools/list-folders): List navigable folders for an account, with roles (inbox, sent, drafts, trash, spam, starred).− - [List labels](https://fluxmail.ai/docs/tools/list-labels): List Gmail user labels or Outlook categories for an account.− - [List scheduled emails](https://fluxmail.ai/docs/tools/list-scheduled-emails): List scheduled sends: pending ones first (with sendAt), then past ones (sent, failed, canceled). For failed entries, lastError says what went wrong. Pending sends only fire while the Fluxmail server is running.− - [List send as](https://fluxmail.ai/docs/tools/list-send-as): List sender addresses available for an account.− - [Modify emails](https://fluxmail.ai/docs/tools/modify-emails): Batch-modify emails using the actions allowed for this connection. Moving requires folder; labels require labels.− - [Preview send](https://fluxmail.ai/docs/tools/preview-send): Show the resolved sender, recipients, subject, and attachments without sending.− - [Search emails batch](https://fluxmail.ai/docs/tools/search-emails-batch): Search up to 20 accounts with one portable query and return one result group per account.− - [Search emails](https://fluxmail.ai/docs/tools/search-emails): Search one account with typed portable syntax. The query supports text, from:, to:, subject:, in:, read and starred states, attachments, and date filters.− - [Send email](https://fluxmail.ai/docs/tools/send-email): Send an email from the user's connected account. Three modes: direct (to + subject + body), sending an existing draft (draftId), or replying (replyToMessageId, optionally replyAll) where recipients, subject, and threading are derived from the original. Confirm with the user when intent is ambiguous. Add sendAt to any mode to schedule instead of sending now.− - [Update draft](https://fluxmail.ai/docs/tools/update-draft): Replace the content of an existing draft (full replacement, not a patch).+ > Connect ChatGPT, Claude, and other agents to Gmail, Outlook, or IMAP over MCP. Agents can search, read, draft, and send email with the permissions you approve.+ Fluxmail gives AI agents and apps access to Gmail, Outlook, and IMAP mailboxes. It comes in two forms that share the same email operations and permission model: Fluxmail Cloud, a hosted service, and Fluxmail Self-Hosted, which you run on your own computer or server. The home page compares them.+ Fluxmail Self-Hosted, described at /self-hosted, connects Gmail, Outlook, Exchange, and IMAP mailboxes through MCP, a versioned REST API, and a CLI. All three interfaces can search, read, draft, send, schedule, and organize email. AI agents can connect over local stdio or Streamable HTTP, while apps and backend workflows can use REST. The CLI includes Fluxmail-managed Gmail OAuth and also accepts custom Google credentials. Fluxmail encrypts provider credentials in local storage. Installation ins+ - [Home](https://fluxmail.ai/): Overview of Fluxmail Cloud and Fluxmail Self-Hosted, with a comparison of the two+ - [Fluxmail Self-Hosted](https://fluxmail.ai/self-hosted): Self-hosted email infrastructure for agents and apps, available through MCP, REST API, and CLI+ - [Integrations](https://fluxmail.ai/integrations): Setup guides for ChatGPT, Claude Desktop, Claude Code, Codex, Muse, Cursor, and other MCP clients+ - [Compare](https://fluxmail.ai/compare): Best email MCP servers and APIs for AI agents, plus Fluxmail compared with each one+ - [Email for ChatGPT](https://fluxmail.ai/integrations/chatgpt): Connect ChatGPT to Gmail, Outlook, or IMAP with a custom MCP server. Sign in with OAuth and choose which mailboxes and actions ChatGPT can use.+ - [Email for Claude Desktop](https://fluxmail.ai/integrations/claude-desktop): Connect Gmail, Outlook, or IMAP to Claude Desktop and claude.ai from Claude's connector directory. Sign in with OAuth and choose the mailboxes and actions Claude can use.+ - [Email for Muse](https://fluxmail.ai/integrations/muse): Connect Muse to Gmail, Outlook, or IMAP with a Fluxmail Cloud custom connector. Sign in with OAuth and choose which mailboxes and actions Muse can use.+ - [Fluxmail vs Nylas](https://fluxmail.ai/compare/nylas): Compare Fluxmail and Nylas on MCP, REST, providers, Google verification, data storage, webhooks, permissions, and per-account pricing.+ - [Fluxmail vs Gmail MCP Server](https://fluxmail.ai/compare/gmail-mcp): Compare Gmail MCP pricing, personal Gmail access, and setup. Fluxmail has a free self-hosted plan; Google's server requires Workspace preview enrollment.+ - [Fluxmail vs Work IQ MCP](https://fluxmail.ai/compare/outlook-mcp): Looking for an Outlook MCP server? Compare Fluxmail and Microsoft's Work IQ MCP on hosting, providers, email tools, permissions, setup, and cost.+ - [Fluxmail vs Claude Gmail](https://fluxmail.ai/compare/claude-gmail): Compare Claude's built-in Gmail integration with Fluxmail on attachments, scheduling, Outlook and IMAP support, and setup, and see when the built-in one is enough.+ - [Authentication and instances](https://fluxmail.ai/docs/authentication-and-instances): Log in to local and remote Fluxmail instances, enroll members, manage sessions, connect MCP clients with OAuth, and create API keys.+ - [fluxmail connections accounts](https://fluxmail.ai/docs/cli/connections-accounts): Change the mailboxes one of your OAuth connections can use+ - [fluxmail connections list](https://fluxmail.ai/docs/cli/connections-list): List OAuth connections+ - [fluxmail connections revoke](https://fluxmail.ai/docs/cli/connections-revoke): Disconnect an MCP client and revoke its tokens+ - [fluxmail connections](https://fluxmail.ai/docs/cli/connections): Manage MCP clients connected with OAuth+ - [List OAuth connections for every member or one member](https://fluxmail.ai/docs/rest-api/list-oauth-connections): Reference for GET /api/v1/admin/oauth-connections.+ - [List MCP clients the current member connected with OAuth](https://fluxmail.ai/docs/rest-api/list-own-oauth-connections): Reference for GET /api/v1/me/oauth-connections.+ - [Disconnect a member's OAuth connection](https://fluxmail.ai/docs/rest-api/revoke-oauth-connection): Reference for DELETE /api/v1/admin/oauth-connections/{grantId}.+ - [Disconnect an MCP client the current member connected with OAuth](https://fluxmail.ai/docs/rest-api/revoke-own-oauth-connection): Reference for DELETE /api/v1/me/oauth-connections/{grantId}.+ - [Change the mailboxes an OAuth connection can use](https://fluxmail.ai/docs/rest-api/update-own-oauth-connection): Reference for PATCH /api/v1/me/oauth-connections/{grantId}.+ - [Add labels](https://fluxmail.ai/docs/tools/add-labels): Add labels, or Outlook categories, to messages.+ - [Archive emails](https://fluxmail.ai/docs/tools/archive-emails): Move messages out of the inbox into the archive.+ - [Cancel scheduled email](https://fluxmail.ai/docs/tools/cancel-scheduled-email): Cancel a pending scheduled send by scheduleId (from send_email with sendAt, or list_scheduled_emails). The draft stays in the Drafts folder, so the content is not lost.+ - [Create draft](https://fluxmail.ai/docs/tools/create-draft): Create a draft. For a reply draft, pass replyToMessageId (recipients/subject are derived; replyAll for reply-all).+ - [Delete draft](https://fluxmail.ai/docs/tools/delete-draft): Delete a draft.+ - [Delete emails](https://fluxmail.ai/docs/tools/delete-emails): Permanently delete messages. This cannot be undone. Gmail accounts connected through Fluxmail's built-in Google app cannot delete permanently; move their messages to the trash instead.+ - [Download attachment](https://fluxmail.ai/docs/tools/download-attachment): Get metadata and a resource link for one attachment, up to 10 MB. With inline, the result also includes the content. For a PDF, inline adds extracted text, and pages returns the text of a page range such as 201-400.+ - [Forward email](https://fluxmail.ai/docs/tools/forward-email): Forward an email to new recipients: quoted original body, "Fwd:" subject, original attachments included unless includeAttachments=false. Optional comment appears above the forwarded content.+ - [Get delivery operation](https://fluxmail.ai/docs/tools/get-delivery-operation): Check whether a send or forward succeeded, failed, or has an uncertain outcome.+ - [Get draft](https://fluxmail.ai/docs/tools/get-draft): Read an existing draft by its draft ID.+ - [Get email body](https://fluxmail.ai/docs/tools/get-email-body): Read a bounded portion of one email body. Use nextOffset to continue.+ - [Get email](https://fluxmail.ai/docs/tools/get-email): Fetch one email in full: body (text and/or HTML), recipients, attachment metadata.+ - [Get status](https://fluxmail.ai/docs/tools/get-status): Account connection and scheduled-send status, including accounts that need re-authentication. Administrators also see plan details.+ - [Get thread](https://fluxmail.ai/docs/tools/get-thread): Fetch a page of conversation messages with bounded body content.+ - [MCP tools](https://fluxmail.ai/docs/tools): Use Fluxmail MCP tools to read, search, draft, send, schedule, and organize email.+ - [List accounts](https://fluxmail.ai/docs/tools/list-accounts): List connected email accounts (id, provider, email, status, capabilities).

Showing the first 40 of each.

version

0.15.0 → 0.16.0

version

0.14.0 → 0.15.0

version

0.13.0 → 0.14.0

https://fluxmail.ai/llms.txt

− Fluxmail Desktop is a free, open-source local-first email client with public releases on GitHub, linked from /desktop. It uses the same local Fluxmail service as the CLI, MCP server, and REST API, so people and agents can work with the same connected mailboxes and permission model.− - Fluxmail Desktop architecture: the app uses the local Fluxmail REST API while AI agents connect to the same service over MCP.− - [Fluxmail Desktop](https://fluxmail.ai/desktop): The released desktop client built on the Fluxmail CLI, MCP server, and REST API− - [Pricing](https://fluxmail.ai/pricing): Plans, pricing, and FAQ for the self-hosted service− - [Cancel scheduled email](https://fluxmail.ai/docs/tools/cancel-scheduled-email): Cancel a pending scheduled send by scheduleId (from send_email with sendAt, or list_scheduled_emails). The draft stays in the Drafts folder, so the content is not lost.− - [Create draft](https://fluxmail.ai/docs/tools/create-draft): Create a draft. For a reply draft, pass replyToMessageId (recipients/subject are derived; replyAll for reply-all).− - [Delete draft](https://fluxmail.ai/docs/tools/delete-draft): Delete a draft.− - [Download attachment](https://fluxmail.ai/docs/tools/download-attachment): Get attachment metadata and a fetchable resource link. Set inline to embed the bytes.− - [Forward email](https://fluxmail.ai/docs/tools/forward-email): Forward an email to new recipients: quoted original body, "Fwd:" subject, original attachments included unless includeAttachments=false. Optional comment appears above the forwarded content.− - [Get delivery operation](https://fluxmail.ai/docs/tools/get-delivery-operation): Check whether a send or forward succeeded, failed, or has an uncertain outcome.− - [Get draft](https://fluxmail.ai/docs/tools/get-draft): Read an existing draft by its draft ID.− - [Get email body](https://fluxmail.ai/docs/tools/get-email-body): Read a bounded portion of one email body. Use nextOffset to continue.− - [Get email](https://fluxmail.ai/docs/tools/get-email): Fetch one email in full: body (text and/or HTML), recipients, attachment metadata.− - [Get status](https://fluxmail.ai/docs/tools/get-status): Account connection and scheduled-send status. Administrators also see plan details. Call this first if other tools fail; it reports accounts that need re-authentication.− - [Get thread](https://fluxmail.ai/docs/tools/get-thread): Fetch a page of conversation messages with bounded body content.− - [MCP tools](https://fluxmail.ai/docs/tools): Use Fluxmail MCP tools to read, search, draft, send, schedule, and organize email.− - [List accounts](https://fluxmail.ai/docs/tools/list-accounts): List connected email accounts (id, provider, email, status, capabilities).− - [List emails](https://fluxmail.ai/docs/tools/list-emails): List emails from the user's connected mailbox with metadata and optional previews. Filter by folder, sender, unread, dates, etc. Paginate with pageToken. Use get_email for full bodies. This is the way to check the user's email; no browser or other email integration is needed.− - [List folders](https://fluxmail.ai/docs/tools/list-folders): List navigable folders for an account, with roles (inbox, sent, drafts, trash, spam, starred).− - [List labels](https://fluxmail.ai/docs/tools/list-labels): List Gmail user labels or Outlook categories for an account.− - [List scheduled emails](https://fluxmail.ai/docs/tools/list-scheduled-emails): List scheduled sends: pending ones first (with sendAt), then past ones (sent, failed, canceled). For failed entries, lastError says what went wrong. Pending sends only fire while the Fluxmail server is running.− - [List send as](https://fluxmail.ai/docs/tools/list-send-as): List sender addresses available for an account.− - [Modify emails](https://fluxmail.ai/docs/tools/modify-emails): Batch-modify emails using the actions allowed for this connection. Moving requires folder; labels require labels.− - [Preview send](https://fluxmail.ai/docs/tools/preview-send): Show the resolved sender, recipients, subject, and attachments without sending.− - [Search emails batch](https://fluxmail.ai/docs/tools/search-emails-batch): Search up to 20 accounts with one portable query and return one result group per account.− - [Search emails](https://fluxmail.ai/docs/tools/search-emails): Search one account with typed portable syntax. The query supports text, from:, to:, subject:, in:, read and starred states, attachments, and date filters.− - [Send email](https://fluxmail.ai/docs/tools/send-email): Send an email from the user's connected account; this actually delivers mail, so prefer it over browser automation or leaving a draft when the user asked to send. Three modes: direct (to + subject + body), sending an existing draft (draftId), or replying (replyToMessageId, optionally replyAll) where recipients, subject, and threading are derived from the original. Confirm with the user when intent is ambiguous. Add sendAt to any mode to − - [Update draft](https://fluxmail.ai/docs/tools/update-draft): Replace the content of an existing draft (full replacement, not a patch).− - [Connect an agent over MCP](https://fluxmail.ai/docs/cloud/mcp): Set up Fluxmail Cloud in Codex, Claude Code, Cursor, or VS Code.+ Fluxmail Desktop is a free, open-source email client for macOS with public releases on GitHub, linked from /desktop. It runs the Fluxmail engine inside the app and connects directly to Gmail, Outlook, and IMAP providers, with no Fluxmail server in between. It shares connected accounts with the Fluxmail CLI and MCP server, so people and agents can work with the same mailboxes.+ - Fluxmail Desktop architecture: the app runs the Fluxmail engine in its own process, connects directly to the mail provider, and shares the accounts in `~/.fluxmail` with the Fluxmail CLI and MCP server.+ - [Fluxmail Cloud](https://fluxmail.ai/cloud): Hosted MCP and REST access to Gmail, Outlook, and IMAP mailboxes, with per-agent mailbox and permission approval+ - [Fluxmail Desktop](https://fluxmail.ai/desktop): Free, open-source Mac email client that connects directly to Gmail, Outlook, and IMAP and shares accounts with the Fluxmail CLI and MCP server+ - [Pricing](https://fluxmail.ai/pricing): Plans, pricing, and FAQ for self-hosted Fluxmail and Fluxmail Cloud+ - [Cancel scheduled email](https://fluxmail.ai/docs/tools/cancel-scheduled-email): Cancel a pending scheduled send by scheduleId (from send_email with sendAt, or list_scheduled_emails). The draft stays in the Drafts folder, so the content is not lost.+ - [Create draft](https://fluxmail.ai/docs/tools/create-draft): Create a draft. For a reply draft, pass replyToMessageId (recipients/subject are derived; replyAll for reply-all).+ - [Delete draft](https://fluxmail.ai/docs/tools/delete-draft): Delete a draft.+ - [Download attachment](https://fluxmail.ai/docs/tools/download-attachment): Get metadata and a resource link for one attachment, up to 10 MB. With inline, the result also includes the content. For a PDF, inline adds extracted text, and pages returns the text of a page range such as 201-400.+ - [Forward email](https://fluxmail.ai/docs/tools/forward-email): Forward an email to new recipients: quoted original body, "Fwd:" subject, original attachments included unless includeAttachments=false. Optional comment appears above the forwarded content.+ - [Get delivery operation](https://fluxmail.ai/docs/tools/get-delivery-operation): Check whether a send or forward succeeded, failed, or has an uncertain outcome.+ - [Get draft](https://fluxmail.ai/docs/tools/get-draft): Read an existing draft by its draft ID.+ - [Get email body](https://fluxmail.ai/docs/tools/get-email-body): Read a bounded portion of one email body. Use nextOffset to continue.+ - [Get email](https://fluxmail.ai/docs/tools/get-email): Fetch one email in full: body (text and/or HTML), recipients, attachment metadata.+ - [Get status](https://fluxmail.ai/docs/tools/get-status): Account connection and scheduled-send status, including accounts that need re-authentication. Administrators also see plan details.+ - [Get thread](https://fluxmail.ai/docs/tools/get-thread): Fetch a page of conversation messages with bounded body content.+ - [MCP tools](https://fluxmail.ai/docs/tools): Use Fluxmail MCP tools to read, search, draft, send, schedule, and organize email.+ - [List accounts](https://fluxmail.ai/docs/tools/list-accounts): List connected email accounts (id, provider, email, status, capabilities).+ - [List emails](https://fluxmail.ai/docs/tools/list-emails): List emails from the user's connected mailbox with metadata and optional previews. Filter by folder, sender, unread, dates, etc. Paginate with pageToken. Use get_email for full bodies.+ - [List folders](https://fluxmail.ai/docs/tools/list-folders): List navigable folders for an account, with roles (inbox, sent, drafts, trash, spam, starred).+ - [List labels](https://fluxmail.ai/docs/tools/list-labels): List Gmail user labels or Outlook categories for an account.+ - [List scheduled emails](https://fluxmail.ai/docs/tools/list-scheduled-emails): List scheduled sends: pending ones first (with sendAt), then past ones (sent, failed, canceled). For failed entries, lastError says what went wrong. Pending sends only fire while the Fluxmail server is running.+ - [List send as](https://fluxmail.ai/docs/tools/list-send-as): List sender addresses available for an account.+ - [Modify emails](https://fluxmail.ai/docs/tools/modify-emails): Batch-modify emails using the actions allowed for this connection. Moving requires folder; labels require labels.+ - [Preview send](https://fluxmail.ai/docs/tools/preview-send): Show the resolved sender, recipients, subject, and attachments without sending.+ - [Search emails batch](https://fluxmail.ai/docs/tools/search-emails-batch): Search up to 20 accounts with one portable query and return one result group per account.+ - [Search emails](https://fluxmail.ai/docs/tools/search-emails): Search one account with typed portable syntax. The query supports text, from:, to:, subject:, in:, read and starred states, attachments, and date filters.+ - [Send email](https://fluxmail.ai/docs/tools/send-email): Send an email from the user's connected account. Three modes: direct (to + subject + body), sending an existing draft (draftId), or replying (replyToMessageId, optionally replyAll) where recipients, subject, and threading are derived from the original. Confirm with the user when intent is ambiguous. Add sendAt to any mode to schedule instead of sending now.+ - [Update draft](https://fluxmail.ai/docs/tools/update-draft): Replace the content of an existing draft (full replacement, not a patch).+ - [Upgrade to 0.14.0](https://fluxmail.ai/docs/upgrades/0.14.0): Choose permissions for stdio clients and new API keys, restore permanent deletion, and read inline attachment content.+ - [Connect an agent over MCP](https://fluxmail.ai/docs/cloud/mcp): Connect Fluxmail Cloud to your agent with OAuth by default, or an agent key for automation.+ - [Introducing Fluxmail Cloud: hosted email access for AI agents](https://fluxmail.ai/blog/introducing-fluxmail-cloud): Fluxmail Cloud is a hosted version of Fluxmail. Connect Gmail, Outlook, or an IMAP mailbox, then give ChatGPT, Claude, Codex, and other agents access over MCP or REST with the mailboxes and permissions you approve.

https://fluxmail.ai/llms.txt

− Fluxmail Desktop is an upcoming local-first email client available for preview at /desktop. It will use the same local Fluxmail service as the CLI, MCP server, and REST API, so people and agents can work with the same connected mailboxes and permission model.− - Self-hosted pricing: the free Personal plan includes 1 member and 3 mailboxes; Pro is $15/month or $120/year (1 member, 10 mailboxes); Business is $25/month or $240/year per member (up to 50 members, with 20 mailbox connections per member added to the instance limit); Enterprise is custom (contact sales).− - Fluxmail Desktop status: the desktop email client is in development and does not have a public release date yet.− - Fluxmail Desktop architecture: the app will use the local Fluxmail REST API while AI agents connect to the same service over MCP.− - [Fluxmail Desktop](https://fluxmail.ai/desktop): The upcoming desktop client built on the Fluxmail CLI, MCP server, and REST API− - [Fluxmail vs Gmail MCP Server](https://fluxmail.ai/compare/gmail-mcp): Compare Fluxmail and Google's Gmail MCP Server on hosting, providers, tools, permissions, and setup. See which email MCP fits your agent.− ### Fluxmail MCP− - [Build with REST](https://fluxmail.ai/docs/build-with-rest): Connect an app or script to the Fluxmail REST API and make your first requests.− - [Connect an MCP client](https://fluxmail.ai/docs/connect-an-mcp-client): Connect Claude, ChatGPT, Codex, Cursor, Hermes, Gemini, or another MCP client to Fluxmail.− - [Deploy with Docker](https://fluxmail.ai/docs/deploy-with-docker): Run Fluxmail in Docker for remote access or a shared instance.− - [Overview](https://fluxmail.ai/docs): How Fluxmail connects agents and apps to Gmail, Outlook, and IMAP through MCP, REST API, and CLI.− - [Quickstart](https://fluxmail.ai/docs/quickstart): Install Fluxmail, create the first administrator, and connect a Gmail, Outlook, or IMAP mailbox.− - [fluxmail accounts access](https://fluxmail.ai/docs/cli/accounts-access): Set who can access a mailbox− - [fluxmail accounts add](https://fluxmail.ai/docs/cli/accounts-add): Connect a Gmail, Outlook, or IMAP account− - [fluxmail accounts assign](https://fluxmail.ai/docs/cli/accounts-assign): Change mailbox ownership− - [fluxmail accounts configure](https://fluxmail.ai/docs/cli/accounts-configure): Set special folder paths for an IMAP account− - [fluxmail accounts list](https://fluxmail.ai/docs/cli/accounts-list): List connected accounts− - [fluxmail accounts remove](https://fluxmail.ai/docs/cli/accounts-remove): Disconnect an account and delete its stored tokens− - [fluxmail accounts send-as add](https://fluxmail.ai/docs/cli/accounts-send-as-add): Add a configured Outlook or IMAP sender address− - [fluxmail accounts send-as list](https://fluxmail.ai/docs/cli/accounts-send-as-list): List available sender addresses− - [fluxmail accounts send-as remove](https://fluxmail.ai/docs/cli/accounts-send-as-remove): Remove a configured Outlook or IMAP sender address− - [fluxmail accounts send-as](https://fluxmail.ai/docs/cli/accounts-send-as): Manage sender addresses− - [fluxmail accounts](https://fluxmail.ai/docs/cli/accounts): Manage connected email accounts− - [fluxmail apikey accounts](https://fluxmail.ai/docs/cli/apikey-accounts): Replace or clear an API key mailbox allowlist− - [fluxmail apikey capabilities](https://fluxmail.ai/docs/cli/apikey-capabilities): List capabilities for API key permission policies− - [fluxmail apikey create](https://fluxmail.ai/docs/cli/apikey-create): Create an API key (shown once)− - [fluxmail apikey list](https://fluxmail.ai/docs/cli/apikey-list): List API keys− - [fluxmail apikey permissions](https://fluxmail.ai/docs/cli/apikey-permissions): Change the permissions for an API key− - [fluxmail apikey revoke](https://fluxmail.ai/docs/cli/apikey-revoke): Revoke an API key− - [fluxmail apikey](https://fluxmail.ai/docs/cli/apikey): Manage API keys for the HTTP MCP and REST APIs− - [fluxmail attachments download](https://fluxmail.ai/docs/cli/attachments-download): Download an attachment− - [fluxmail attachments](https://fluxmail.ai/docs/cli/attachments): Download message attachments− - [fluxmail auth recover-admin](https://fluxmail.ai/docs/cli/auth-recover-admin): Reset an administrator password using local filesystem access− - [fluxmail auth revoke-session](https://fluxmail.ai/docs/cli/auth-revoke-session): Revoke one of the current member's sessions− - [fluxmail auth sessions](https://fluxmail.ai/docs/cli/auth-sessions): List sessions for the current member− - [fluxmail auth](https://fluxmail.ai/docs/cli/auth): Manage interactive authentication− - [fluxmail config init](https://fluxmail.ai/docs/cli/config-init): Create config.toml in the Fluxmail data directory− - [fluxmail config migrate](https://fluxmail.ai/docs/cli/config-migrate): Import settings from an env file without deleting it− - [fluxmail config show](https://fluxmail.ai/docs/cli/config-show): Show effective configuration, sources, paths, and restart requirements− - [fluxmail config](https://fluxmail.ai/docs/cli/config): Inspect and initialize deployment configuration+ Fluxmail Desktop is a free, open-source local-first email client with public releases on GitHub, linked from /desktop. It uses the same local Fluxmail service as the CLI, MCP server, and REST API, so people and agents can work with the same connected mailboxes and permission model.+ Fluxmail Cloud provides hosted MCP and REST access to existing mailboxes at cloud.fluxmail.ai. Cloud uses separate mailbox connections, OAuth authorization for MCP clients, and scoped agent keys for REST automation. Cloud documentation is at /docs/cloud, with a pasteable agent setup prompt at /docs/cloud/quickstart#agent-first-setup and a Cloud-only plain-text guide at /docs/cloud/llms.txt. Cloud offers Pro and Business subscriptions, a seven-day trial on a workspace's first subscription, and wo+ - Self-hosted pricing: the free Personal plan includes 1 member and 3 mailboxes; Pro is $15/month or $120/year (1 member, 10 mailboxes); Business is $25/month or $240/year per member (up to 100 members, with 20 mailbox connections per member added to the instance limit); Enterprise is custom (contact sales).+ - Fluxmail Desktop status: the desktop email client has public releases available on GitHub.+ - Fluxmail Desktop architecture: the app uses the local Fluxmail REST API while AI agents connect to the same service over MCP.+ - [Fluxmail Desktop](https://fluxmail.ai/desktop): The released desktop client built on the Fluxmail CLI, MCP server, and REST API+ - [Fluxmail vs Gmail MCP Server](https://fluxmail.ai/compare/gmail-mcp): Compare Gmail MCP pricing, personal Gmail access, and setup. Fluxmail has a free self-hosted plan; Google's server requires Workspace preview enrollment.+ Self-hosted setup instructions for coding agents: https://fluxmail.ai/docs/self-hosted/setup.txt+ Self-hosted guides and reference only: https://fluxmail.ai/docs/self-hosted/llms.txt+ ### Fluxmail Self-Hosted+ - [Back up and restore](https://fluxmail.ai/docs/backup-and-restore): Preserve the database and encryption key, then restore an installation from a complete backup.+ - [Build with REST](https://fluxmail.ai/docs/build-with-rest): Create a scoped key, verify provider access, and read your first inbox messages.+ - [Connect an MCP client](https://fluxmail.ai/docs/connect-an-mcp-client): Choose your MCP client, configure local or HTTP access, and verify the mailbox connection.+ - [Deploy with Docker](https://fluxmail.ai/docs/deploy-with-docker): Run a persistent Fluxmail server, configure HTTPS, and verify a client connection.+ - [Fluxmail Self-Hosted](https://fluxmail.ai/docs/self-hosted): Connect your existing mailboxes to agents and apps with a Fluxmail server you control.+ - [Quickstart](https://fluxmail.ai/docs/quickstart): Install Fluxmail, connect a mailbox, and verify your first agent or CLI connection.+ - [Sending and retries](https://fluxmail.ai/docs/sending-and-retries): Preview a send, track its delivery, and retry without sending a duplicate.+ - [Telemetry](https://fluxmail.ai/docs/telemetry): See what usage data Fluxmail sends and how to turn it off.+ - [Upgrade Fluxmail](https://fluxmail.ai/docs/upgrade-fluxmail): Back up an installation, check client compatibility, and verify an upgrade.+ - [fluxmail accounts access](https://fluxmail.ai/docs/cli/accounts-access): Set who can access a mailbox+ - [fluxmail accounts add](https://fluxmail.ai/docs/cli/accounts-add): Connect a Gmail, Outlook, or IMAP account+ - [fluxmail accounts assign](https://fluxmail.ai/docs/cli/accounts-assign): Change mailbox ownership+ - [fluxmail accounts configure](https://fluxmail.ai/docs/cli/accounts-configure): Set special folder paths for an IMAP account+ - [fluxmail accounts list](https://fluxmail.ai/docs/cli/accounts-list): List connected accounts+ - [fluxmail accounts remove](https://fluxmail.ai/docs/cli/accounts-remove): Disconnect an account and delete its stored tokens+ - [fluxmail accounts send-as add](https://fluxmail.ai/docs/cli/accounts-send-as-add): Add a configured Outlook or IMAP sender address+ - [fluxmail accounts send-as list](https://fluxmail.ai/docs/cli/accounts-send-as-list): List available sender addresses+ - [fluxmail accounts send-as remove](https://fluxmail.ai/docs/cli/accounts-send-as-remove): Remove a configured Outlook or IMAP sender address+ - [fluxmail accounts send-as](https://fluxmail.ai/docs/cli/accounts-send-as): Manage sender addresses+ - [fluxmail accounts](https://fluxmail.ai/docs/cli/accounts): Manage connected email accounts+ - [fluxmail apikey accounts](https://fluxmail.ai/docs/cli/apikey-accounts): Replace or clear an API key mailbox allowlist+ - [fluxmail apikey capabilities](https://fluxmail.ai/docs/cli/apikey-capabilities): List capabilities for API key permission policies+ - [fluxmail apikey create](https://fluxmail.ai/docs/cli/apikey-create): Create an API key (shown once)+ - [fluxmail apikey list](https://fluxmail.ai/docs/cli/apikey-list): List API keys+ - [fluxmail apikey permissions](https://fluxmail.ai/docs/cli/apikey-permissions): Change the permissions for an API key+ - [fluxmail apikey revoke](https://fluxmail.ai/docs/cli/apikey-revoke): Revoke an API key+ - [fluxmail apikey](https://fluxmail.ai/docs/cli/apikey): Manage API keys for the HTTP MCP and REST APIs+ - [fluxmail attachments download](https://fluxmail.ai/docs/cli/attachments-download): Download an attachment+ - [fluxmail attachments](https://fluxmail.ai/docs/cli/attachments): Download message attachments+ - [fluxmail auth recover-admin](https://fluxmail.ai/docs/cli/auth-recover-admin): Reset an administrator password using local filesystem access

Showing the first 40 of each.