Let your agent read your email

The single biggest unlock for most users is giving your agent access to email. Once connected, it can:

• Triage your inbox every morning and tell you what actually matters
• Draft replies for your approval (or send them automatically if you trust it)
• Search your history — “when did I last email Sarah about the Q2 report?”
• Schedule follow-ups — “remind me to nudge Acme if they don’t reply by Friday”
• Label and organize — move newsletters out, flag customer emails, archive automation noise

Before you start

You need one thing: an app password for your email account. This is NOT your regular password. Gmail, Outlook, Yahoo, and iCloud all support app passwords as a safer way for third-party apps to access your email. We’ll walk you through how to get one below.

Email and calendar are included on every tier — trial, Standard, and Pro. Connect as many inboxes as you want at no extra cost.

App passwords, not regular passwords

We will never ask for your regular email password. Only app passwords, which you can revoke at any time from your email provider’s account settings. This means if you ever want to disconnect your agent, you can do it from your email account independently of anything we do.

Setting up the connection

1. Go to Settings → Integrations → Email

From the dashboard, click Settings in the sidebar, then Integrations, then Email. Click Add email account.

2. Get an app password from your provider

This is the part that trips people up the most. Here are direct links and instructions for the big providers:

Gmail / Google Workspace

1. Make sure 2-Step Verification is turned ON. Google requires this before you can create app passwords.
2. Go to myaccount.google.com/apppasswords.
3. In the “App name” field, type “My Agent Platform”, then click Create.
4. Google will show you a 16-character password (formatted like abcd efgh ijkl mnop). Copy it without the spaces.

Outlook / Hotmail / Office 365

1. Go to account.microsoft.com/security.
2. Click Advanced security options.
3. Under “App passwords,” click Create a new app password.
4. Copy the password that appears.

iCloud / Apple Mail

1. Sign in to appleid.apple.com.
2. Under “Sign-In and Security,” click App-Specific Passwords → Generate an app-specific password.
3. Label it “My Agent Platform” and copy the password Apple generates.

Yahoo Mail

1. Go to login.yahoo.com/account/security.
2. Click Generate app password.
3. Enter “My Agent Platform” as the app name and copy the password.

Custom domain / self-hosted (any IMAP provider)

If your email lives on your own domain (you@yourcompany.com) or a provider we don’t auto-detect, you can still connect it — anything that speaks IMAP works. That includes Fastmail, ProtonMail Bridge, Zoho Mail, Migadu, mailcow, Dovecot, Postfix, cPanel mail, and most business/hosted email setups.

In the connect dialog, click Use custom IMAP/SMTP and you’ll get fields for:

• IMAP host and port (usually imap.yourdomain.com on port 993 with SSL)
• SMTP host and port (usually smtp.yourdomain.com on port 465 with SSL, or 587 with STARTTLS)
• Username (often your full email address)
• Password — use an app-specific password if your provider supports it; otherwise your mailbox password

Your hosting provider’s help docs will have the exact server names and ports. If you’re self-hosting, you already know them.

3. Enter your email and app password

Back in the dashboard’s email setup screen, type your email address and paste the app password you just generated. We’ll auto-detect your provider (Gmail, Outlook, Yahoo, iCloud) and fill in the correct IMAP and SMTP servers — or click Use custom IMAP/SMTP if you’re connecting a private domain.

Click Connect. We validate the connection immediately — if the password is wrong or your provider blocks the connection, you’ll see an error right away instead of a silent failure later.

4. Your agent sees your inbox

That’s it. Your agent now has read access to your inbox. It will NOT start touching anything without being asked — it will wait for your first email-related instruction.

Try asking:

“Catch me up on my inbox”

or

“Are there any emails I need to reply to today?”

What your agent can and can’t do with your email

Action	Requires approval?
Read emails	No (agent has full read access)
Search your inbox	No
Summarize your inbox	No
Draft a reply	No (drafts are just proposed text)
Send an email	Yes by default — you approve every send
Delete an email	Yes by default — requires approval
Apply labels / move to folders	Configurable (see Trust levels)

You can loosen or tighten these defaults in Settings → Agent → Agent Trust & Approvals. See Trust levels & approvals → for the full explanation.

Privacy

• Your app password is encrypted at rest using AES-256 with a key that’s unique to your agent.
• Only your agent can read it. Nobody on our team has access.
• When you disconnect your email from Settings → Integrations, we delete the password and all stored message metadata immediately.
• We do not train any AI models on your email content.

Disconnecting

From the dashboard, go to Settings → Integrations → Email and click Disconnect next to the account you want to remove. You can also revoke the app password directly from your email provider’s security settings — that takes effect immediately even if our dashboard is down for any reason.

Troubleshooting

“Connection failed: authentication error” — The app password is wrong, expired, or you pasted it with the spaces still in it. Generate a new one and try again.

“Connection failed: couldn’t reach your provider” — Your email provider may be temporarily down, or your company may have IMAP disabled for security reasons. If you’re on Google Workspace with a corporate admin, ask them to check whether IMAP is enabled for your account.

“The agent isn’t finding recent emails” — IMAP sync can take a minute after the initial connection. Give it 30-60 seconds and try asking again. If it’s been longer than that, see Email isn’t syncing →.

Still stuck?

Click the Ask your agent button in the bottom-right of this page. If you’re signed in, your own agent can walk you through the connection step by step — and it already knows your context.