Connecting mailboxes

Before you start

You'll need an active Aiemaily account. If you're connecting Gmail, keep the Google account you want to add open in another tab. For IMAP/SMTP accounts, have your host address, ports, and app password ready.

The number of mailboxes you can add depends on your plan. Existing connections are listed under Settings → Mailboxes.

Connecting a Gmail account

1. 1

   Open Settings → Mailboxes

   Click the gear icon in the sidebar, then choose Mailboxes from the left rail.

2. 2

   Click "Add mailbox"

   A provider picker slides open. Select Gmail.

3. 3

   Authorise with Google

   A pop-up opens the Google OAuth consent screen. Sign in and grant the requested mail scopes. Aiemaily requests only the minimum scopes needed to read, send, and label mail.

4. 4

   Name the account

   Give the mailbox a display name and pick an accent colour so it's easy to tell apart in the sidebar.

5. 5

   Let the first sync run

   Aiemaily fetches your recent threads in the background. The inbox is usable within seconds; full history syncs progressively.

Connecting an IMAP/SMTP account

1. 1

   Open Settings → Mailboxes → Add mailbox

   Select IMAP/SMTP from the provider picker.

2. 2

   Choose a preset or enter custom settings

   Select a provider from the preset list (iCloud, Fastmail, Proton Bridge, or others) to fill in host and port values automatically, or enter them manually for a custom server.

3. 3

   Enter your credentials

   Provide the email address and the app password (or account password) for the IMAP user. Most providers require an app-specific password when two-factor authentication is on.

4. 4

   Test and save

   Aiemaily verifies the connection before saving. If the test fails, a hint indicates which setting is likely wrong.

5. 5

   Set display options

   Assign a display name, colour, and default send-from address, then save.

Supported providers

Per-mailbox settings

Each connected mailbox has its own settings panel, reachable from Settings → Mailboxes → (select account).

• Display name and accent colour — shown in the sidebar and thread list.
• Default send-from address — used when composing from the unified inbox.
• Signature — per-account HTML or plain-text signature appended to outgoing mail.
• Agent context — a short note that tells the AI the role or persona for this mailbox (e.g. "work account, formal tone").
• Sync on/off and auto-sync interval — pause syncing for accounts you rarely use, or set a custom polling interval for IMAP.