Cloud quickstart

You need a Fluxmail Cloud account and a mailbox you can authorize.

Agent-first setup

Paste this prompt into your coding agent. It will help you choose mailbox access, configure your MCP client, and test the connection. You'll complete sign-in, provider consent, and agent authorization when prompted.

Set up Fluxmail Cloud. Read https://fluxmail.ai/docs/cloud/setup.txt and follow the setup guide. Configure the connection, let me choose mailboxes and permissions in Fluxmail, and verify it works. Guide me through any sign-in or consent steps.

Manual setup

Open Fluxmail Cloud. If you're new, sign up with your email address and open the verification email before signing in.

2. Choose a plan and connect a mailbox

Select your workspace in the sidebar. If it needs a subscription, open Billing and choose a plan. The first subscription includes a seven-day trial; checkout collects payment details. If you joined another workspace, its owner manages billing. See billing and plans.

Open Mailboxes. Choose Gmail or Outlook and authorize the connection, or enter your provider's IMAP and SMTP settings. See connect mailboxes for provider-specific instructions.

3. Connect your MCP client

Select the permissions your agent needs in the MCP setup instructions: Read emails, Manage drafts, Organize emails, Move to/from Trash, Permanently delete emails, and Send emails. Use a preset to select a starting combination. Full mail access is selected by default and excludes permanent deletion. Add the selected MCP URL to your client using its instructions, then sign in to Fluxmail when it opens your browser.

4. Approve access

Choose one workspace, select the mailboxes your client can use, and approve its permissions. Every requested permission starts checked, including Send emails. You can uncheck any permission before approving. Access to all current and future mailboxes is a separate choice.

The browser returns you to your client. You can inspect and revoke the connection in Connections.

For REST automation or a client without OAuth, create an agent key and follow the REST API guide.

5. Verify access

After your client loads the server, check that its tools match the permissions you approved. If your connection includes mail.read, ask your agent to list your 5 most recent emails:

Use Fluxmail Cloud to list my 5 most recent emails. First list
the mailboxes this connection can access, then call list_emails with the
intended accountId, pageSize: 5, and includeSnippet: false. Report whether
both calls succeeded. Do not open message bodies, send mail, create drafts,
or change messages during this check.

This confirms that your client is authorized and Cloud can reach your email provider. The check lists message summaries without opening message bodies or changing your mail. A successful email listing also completes the dashboard's agent onboarding step.

For a connection without mail.read, verify tool discovery only. Provider access remains unchecked; don't send a test message to verify it. If MCP needs a client restart, verify it after restarting. OAuth tokens authorize MCP only; a REST check requires a separate read-scoped key.

If a step fails, see troubleshooting.