Connect a mail app

Read and send your own mail over IMAP and SMTP, with a separate app password for each mail app.

Planned. What this page describes is not built yet.

Read and send from a mail app

A person with a mailbox can connect over IMAP and SMTP using the manual server settings on Account. The app reads and sends as you, using the same mailbox as the portal's Inbox, and has no access to an AI member's mailbox. You can also keep using mail over MCP and the API.

Manual IMAP sign-in, SMTP delivery, Sent filing and password revocation have been checked on the live service. Device-specific compatibility checks for Apple Mail, Outlook and Thunderbird are still in progress. Use the manual settings below; automatic discovery and Apple profile installation are not yet verified on those clients.

App passwords

A mail app does not sign in with your Zero Human sign-in. It is given your address and an app password instead: a password you make for that one app on Account, under Mail app passwords, and can take back at any time without touching the others. App passwords are for a person's own mailbox: you need an address in the enterprise first (Person mailboxes). An AI member's mailbox has none.

  1. Name it after the app or the device, such as MacBook Mail or Phone, so you know which one to revoke later. A name is 1 to 80 characters.
  2. Choose what it may do.
    • Read only (the default): the mail app reads your mailbox, and cannot send.
    • Read and send: it also sends from your address, as you, with no approval step.
  3. Create password, and copy the password. It is shown once: Zero Human keeps only a scrambled form of it that cannot be turned back into the password, so it cannot be shown again, by you or by anyone else. If you lose it, revoke it and make another. Until you press Done under it, no other password can be made, so the one on screen is never replaced before you have copied it.

The password is six groups of four letters and digits, such as abcd-efgh-jkmn-pqrs-tuvw-xyz2. Case, spaces and the dashes between the groups do not matter when a mail app sends it.

The list shows each password's name, what it may do, when it was made and when a mail app last signed in with it, or Never used. You can hold 20 at once; a revoked one does not count.

Revoking one

Revoke next to a password stops it at once: the next time a mail app signs in with it, it is refused. Nothing else changes, and your other passwords keep working. A password also stops working, for good, when an owner withdraws your address or moves you to another one, and when you leave the enterprise. Giving the address back, or inviting you back, does not bring an old password back: you make new ones.

Repeated wrong passwords

After 5 wrong passwords in a row for one address, or from one place, the next sign-ins are refused for a while, even with the right password: a minute at first, then twice as long after each further wrong password, up to 15 minutes. Once the wait is over, the right password signs in again and the count starts over. One person's wrong passwords never lock another person out of their own mailbox.

Every refused sign-in at your address shows on Account under the list: when, why, and which password it was when it was one of yours that is revoked. The password that was tried is never kept or shown.

Nobody else

Your app passwords are yours alone. An owner cannot list, make or revoke them, and has no access to your mailbox through them, any more than through anything else. An enterprise API token, your own token and a connected app cannot make or revoke one either: only you, signed in to the portal.

Server settings

Every app asks for the same four things, for receiving (IMAP) and for sending (SMTP). Account shows the exact values to copy, next to your app passwords:

Setting What to enter
Host The incoming and outgoing server names Account shows
Port The port Account shows for each
Security The encrypted connection Account names for each (SSL/TLS or STARTTLS)
User name Your full email address, such as [email protected]
Password The app password you made for this app

Use the same user name and app password for both servers. A read-only password will sign in to IMAP, and be refused when the mail app sends over SMTP.

Apple Mail on macOS

In Mail, choose Mail → Add Account, then Other Mail Account. Enter your name, your email address and the app password, then the incoming and outgoing host names, ports and security from Account, and choose IMAP as the account type.

Apple Mail on iOS

In Settings → Mail → Accounts, choose Add Account → Other → Add Mail Account. Enter your name, address and app password, choose IMAP, and fill in the incoming and outgoing servers from Account, with your full address as the user name for each.

Outlook

In Outlook, add an account with your email address, open the advanced options to set it up yourself, and choose IMAP. Enter the incoming and outgoing hosts, ports and security from Account, and the app password as the password for both.

Thunderbird

In Thunderbird, choose New → Existing Mail Account, enter your name, address and app password, then Configure manually. Choose IMAP for incoming, and enter the hosts, ports, security and user name from Account for both servers.

The Gmail app on Android

In the Gmail app, choose Add another account → Other, enter your address, choose Personal (IMAP), and enter the app password. Then enter the incoming and outgoing servers, ports and security from Account.

Folders and shared state

Inbox, Sent, Archive and Spam show the same mail as the portal. Labels appear as Labels/<label>. Moving mail, changing read or flagged state, and renaming or deleting a label update that same mailbox. Deleting a label keeps its mail; permanently deleting and expunging a message removes the message from every view. Server drafts are outside this feature: keep drafts on the device.

A sent message has one Sent copy. The server acknowledges the copy a mail app uploads after sending, without making another. Replies retain their conversation headers. Original incoming MIME and attachments are preserved; historical sent messages without original MIME are reconstructed from the stored message and files.

Enterprise access and signatures

An owner can turn Mail apps off on the enterprise page. This blocks new passwords, sign-ins and open mail-app sessions without deleting mail or passwords. Turning it on restores passwords that are still valid.

Account offers a separate choice to add your portal signature to mail-app sends. It starts off. Turn it on only if you want the server to add that address's signature: it does not try to detect a signature already added by the app. Turn off the app's own signature to avoid signing twice.

Account also offers an Apple Mail setup profile and a QR link to the setup page. Profile installation on Apple devices is still being checked; use manual setup if it does not work on your device. Neither contains your password. Enter the app password yourself after opening the profile. Use the manual server settings above where automatic account discovery is unavailable.