twinly. / Docs

Docs · 09

Email (Gmail)

Connect your Gmail with one Google App Password and “email someone” becomes a single action: the twin sends through Gmail directly, reads your inbox, searches it, and quietly tells you when something new lands. About five minutes.

01What it unlocks

  • Instant send. Email goes out through Gmail directly, in one step. No browser puppeteering, no Mail windows flashing open. After a send, Twinly checks your Sent box to confirm it went.
  • Inbox reading. Ask what is in your inbox and the twin lists recent mail (sender, subject, first line) and can open any message in full.
  • Search and context. The twin can find a specific message to ground a reply or pull a detail.
  • New-mail awareness. Twinly checks your inbox every few minutes and posts a calm banner when something new arrives (New email · Sarah Chen / Lunch tomorrow?), no sound, with its own switch.

Apple Mail is the fallback: if Gmail is not connected, the twin uses Mail and tells you what happened.

02What you need

  • A Google account with 2-Step Verification turned on. App passwords do not exist without it.
  • About two minutes on Google's account page.

03Create the App Password

  1. Go to myaccount.google.com/security and make sure 2-Step Verification is on.
  2. Open myaccount.google.com/apppasswords (or search app passwords in the account settings search box).
  3. Name it Twinly and click create. Google shows a 16-character password once. Copy it; the spaces in it do not matter.

An app password is a limited credential: it lets one app sign in to mail, it does not reveal your real Google password, and you can revoke it from the same page any time.

04Connect it in Twinly

Open Settings ▸ Gmail, enter your Gmail address and the app password, and you are done. New-mail awareness has its own switch there (on by default).

05Privacy

The app password is stored in your OS keychain (the macOS Keychain, or Windows Credential Manager on a PC) and is only ever sent over an encrypted connection, directly to Google's mail servers. Your mail is not routed through Twinly. The twin reads your inbox only when a task needs it. Whether a send waits for your OK, or shows for 5 seconds first, follows your approval mode; emails to family always wait.