Cloud quickstart
Connect a mailbox and make your first verified agent connection.
You need an email address for your Fluxmail Cloud account and a mailbox you can authorize.
Agent-first setup
Paste this prompt into your coding agent. If you don't have an account, a plan, or a connected mailbox yet, it walks you through those steps first. Then it sets up your MCP client, or tells you what to enter in your app's settings, and checks the connection. You'll sign in and approve mailbox and agent access yourself in your browser. New accounts start with a seven-day Pro trial without a card.
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
1. Sign in to Cloud
Open Fluxmail Cloud. If you're new, sign up with your email address, then enter the code from the verification email or open its link.
2. Connect a mailbox
The first time you sign in, Cloud starts a seven-day Pro trial that doesn't need a card and opens the dashboard. You can change the plan in Billing. If you joined someone else's workspace, Cloud opens that workspace instead, and 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.
Last updated