Let your agents read a mailbox for you: Gmail in one click through Google, or Outlook, Yahoo, iCloud and others with an app password. Read-only: agents never send, delete or change mail there.
A lot of the business arrives by email: supplier invoices, inquiries from the website, receipts. When an agent can read the mailbox, you can ask it “find this month’s invoices from the suppliers” or “which inquiries did nobody answer?”. A clinic owner, for example, connects the clinic’s Gmail once and lets the bookkeeping agent pull the invoices every month. The connection is read-only.
What an agent can actually do with the mailbox: Read-only. The agent can list the folders, search messages by date, sender, subject or attachments, read a single message, and save an attachment, such as an invoice. It can never send mail, never delete mail, and never change anything in the mailbox. When an agent writes email, it writes from its own address at finemail.app, see WhatsApp and email.
1. Open the mailbox card: Go to /connections. The card Gmail & mailboxes for your agents is near the top.
2. Click Connect Gmail with Google: Under Connect your Gmail in one click, click Connect Gmail with Google. A Google window opens.
3. Approve in Google: Choose the Google account of the mailbox and approve. No app password is needed. Back on the card the mailbox shows as Gmail - connected with Google.
4. Choose which agents may read it: Under the mailbox, next to Agents that may read it:, click the agents. Their mailbox reading capability is switched on for them automatically.
IMAP is the standard way for a program to read a mailbox, used by Outlook, Yahoo, iCloud and almost every email provider. An app password is a separate password that your provider creates for one program. You use it instead of your normal password, and you can cancel it at any time without changing your normal password. Most providers show the app-password page only after 2-step verification (a code to your phone on every new sign-in) is turned on for the account.
1. Open the form: On the mailbox card click Other mailbox (IMAP, app password) (on some accounts the button reads Connect a mailbox).
2. Choose the provider: Under Mail provider choose yours: Gmail / Google Workspace, Outlook / Microsoft 365, Yahoo Mail, iCloud Mail or Fastmail. For any other, choose Custom IMAP server and fill IMAP server address (for example imap.your-provider.com) and Port. IMAP over TLS uses port 993; the platform accepts only that port.
3. Create the app password: Read the box Use an app password - not your normal account password. Click Open the app-password page, turn on 2-step verification if the provider asks, create a password and copy it. The table below says where each provider keeps it.
4. Fill the details: Type the Mailbox address, paste the 16 characters into App password, and if you want, a Name for this mailbox (optional), such as “Invoices inbox”.
5. Connect: Click Connect mailbox. The platform signs in once, right away, to check it works; nothing is stored unless the sign-in succeeds. You see the address and how many folders were found. Then choose the agents that may read it, as above.
Provider | Where to create an app password
Gmail / Google Workspace | Google account, Security, 2-Step Verification, App passwords (myaccount.google.com/apppasswords).
Outlook / Microsoft 365 | Microsoft account, Security, Advanced security options, App passwords.
Yahoo Mail | Yahoo Account Security, Generate app password.
iCloud Mail | appleid.apple.com, Sign-In and Security, App-Specific Passwords.
Fastmail | Settings, Privacy & Security, App passwords.
A mailbox is private until you share it: A connected mailbox is not shared with any agent by default. Tick only the agents that need it. To stop sharing, click the agent again. Disconnect removes the mailbox and deletes the stored app password; every agent loses access.
Q: It says “Google did not complete the connection. Please try again.”
A: The Google window was closed or the approval was refused. Click Connect Gmail with Google again, choose the right account and approve all the requested access. If the browser blocked the window, allow pop-ups for this site.
Q: It says “could not connect that mailbox”.
A: The sign-in to the mailbox failed. Check that you pasted the app password and not your normal password, that the address is typed fully, and that IMAP access is on in the provider’s settings. Then try again.
Q: It says “an app password is required” or “the mailbox email address is required”.
A: One of the two fields is empty. Fill both and click Connect mailbox again.
Q: It says “Could not update who may read this mailbox.”
A: The sharing change did not save. Refresh the page and click the agent again.
Q: Can the agent answer emails from my Gmail?
A: No. The connection only reads. The agent can draft an answer and send it from its own finemail.app address, after your approval.
Q: My agent sent me a Google link. What is it?
A: It asks to read your Gmail for a task. Open the link, approve in Google, and the agent gets the mailbox the moment you approve.
Related: Connect your services (Connections), Talk to your agents on WhatsApp and email, Every agent setting, tab by tab, Connect apps and services: calendar, Twilio, MCP servers, An agent is not answering or not working