Email Setup

Connect your email account to Chalie with your address and an app password.

Connecting your email

Connecting email to Chalie takes two things: your email address and an app password. You don’t configure servers or ports — Chalie handles the connection for you.

Step by step

  1. Open the Brain dashboard (the 🧠 brain icon in the top-right corner)
  2. Go to the Capabilities page in the Brain sidebar
  3. Find the Mail capability and click Setup
  4. Fill in the Mail Setup form:
    • Email Address — the address you want Chalie to read and send from
    • App Password — an app-specific password generated by your email provider (see below)
  5. Click Connect

That’s it — there’s no separate server, port, IMAP, or SMTP configuration. Once connected, Chalie can read, search, reply to, and send email.

Generating an app password

Most providers require an app password rather than your normal account password. An app password is a dedicated, revocable credential scoped to a single application.

Gmail / Google Workspace:

  1. Go to myaccount.google.com
  2. Make sure 2-Step Verification is enabled
  3. Navigate to Security → 2-Step Verification → App passwords
  4. Create a new app password for “Mail” and copy the generated 16-character password
  5. Paste it into the App Password field in Chalie

Other providers (iCloud, Fastmail, Yahoo, Outlook): generate an app-specific password from your account’s security settings and use that in place of your regular password. Your normal login password generally will not work.

Troubleshooting

  • Authentication failed — make sure you used an app password, not your normal account password, and that 2-Step Verification is enabled where required
  • Connection failed — double-check the email address is correct and that your provider allows app-password access
  • Provider blocks access — some providers require you to explicitly enable third-party or app-password access in their security settings before it will work