twinly. / Docs

Docs · 06

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.
  • Inbox reading. Ask what's in my 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 periodically and posts a calm banner when something new arrives (New email · Sarah Chen / Lunch tomorrow?), no sound, capped per batch, with its own toggle.

Apple Mail stays as the fallback: if Gmail is not connected or a send fails, the twin falls back 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. The new-mail awareness has its own toggle there (on by default).

05Privacy

The app password is stored in the macOS Keychain and is only ever sent over an encrypted connection, directly to Google's mail servers. Your mail is not routed through Twinly or any third party. The twin reads your inbox only when a task needs it, and it follows the same approval gate as everything else: it drafts an email freely, but it waits for your OK before actually sending it.