Connect mailboxes

Open Mailboxes in the dashboard and choose your provider. Your workspace needs a trial or paid subscription. Pro includes ten mailbox connections; Business includes twenty per purchased member, pooled across the workspace. See billing and plans. After connecting, authorize an MCP client or create an agent key for REST access.

Gmail and Google Workspace

Choose Gmail, sign in to Google, and authorize Cloud. Cloud uses the Gmail API and requests gmail.modify, which covers reading, drafts, sending, labels, and Trash. Cloud rejects permanent message deletion for Gmail OAuth connections.

Choose the agent key's scopes to restrict how much of that access an agent can use. If Google blocks consent or the provider is unavailable, see connection troubleshooting.

Outlook and Microsoft accounts

Choose Outlook and authorize your Microsoft account. Cloud requests Mail.ReadWrite, Mail.Send, MailboxSettings.Read, User.Read, and offline_access. Work and personal accounts depend on the registered application's configuration; your organization may require administrator consent.

IMAP and SMTP

For iCloud, Yahoo, AOL, and Fastmail addresses, the dashboard fills in the server settings. Check them against your provider's current instructions. Use an app password if your provider requires one. Gmail uses the Google connection flow in the dashboard.

For another provider, enter the mailbox address, password, optional login username, and both servers. The username defaults to your email address.

Cloud requires public DNS hostnames and verified TLS certificates. IP addresses, private servers, port 25, and plaintext connections are not accepted. Cloud checks both IMAP login and SMTP authentication before saving the connection, including when you plan to give the agent read-only access.

Enable Save sent mail to save a copy of each SMTP submission in your Sent folder. Turn it off if your provider already saves sent submissions to avoid duplicate copies.

Folder mappings

If Cloud cannot detect folders, expand Folder mappings and enter their exact paths for Sent, Drafts, Trash, Archive, or Spam. Preserve the provider's case, spaces, and accents. Leave a mapping empty to use automatic detection. To change an existing connection's mappings, reconnect the same address with the updated settings; Cloud preserves its mailbox ID and agent grants.

Reconnect or disconnect

If provider authorization expires or is revoked, reconnect in the dashboard. After reconnecting, ask your agent to list your 5 most recent emails using its OAuth connection or agent key.

Disconnecting removes the Cloud mailbox connection and its send-operation records. Mail already stored at your provider remains there. Before disconnecting, check any uncertain sends. Reconnecting does not restore their duplicate-send protection.