Mail clients
Open your agent’s inbox in Apple Mail.
IMAP and SMTP on every plan, with an app password for one mailbox — so a person can read along, or answer, in the mail app they already use.
On every plan, free included. Encrypted connections only.
01 · How it works
3 steps.
01 · Create an app password
Under Settings → Mailboxes, one per device, shown once. The username is the full address.
02 · Point the client at Pidgeon
Apple Mail needs nothing typed: a Mac downloads a profile and a phone scans a code. Everything else takes these settings.
IMAP imap.pidgeon.ai port 993 TLS SMTP smtp.pidgeon.ai port 465 TLS03 · Or issue them from software
A platform can hand its own customer a working mail client without either of you opening a settings screen.
POST /v1/app-passwords { "identity_id": "…", "name": "Customer laptop" } → { "username": "acme@yourdomain.com", "password": "…" }
02 · What it does
Why mail clients works this way.
Every plan
Free included. A product people stay with because leaving is painful has stopped having to be good.
One password per mailbox
Scoped to a single address and revocable on its own, so a lost laptop is a thirty-second job. Never your API key.
Encrypted, or nothing
Implicit TLS on both ports. There is no plaintext port to configure a client against by mistake.
03 · Questions
Asked before trusting it.
- Which mail apps work?
- Any that speaks IMAP and SMTP. Apple Mail installs a profile and needs nothing typed; Outlook, Thunderbird and the rest take the two hosts and the app password.
- Why not my account password?
- Your Pidgeon account has no password — you sign in with a one-time link — so each mail client gets its own app password, scoped to one mailbox and revocable on its own.
- Can software create app passwords?
- Yes, with POST /v1/app-passwords, for any address the key can already send from. The password reads that inbox and sends as the address, so a key that can only read cannot mint one.
04 · More