Email Setup

Connect your email account to Chalie over IMAP and SMTP.

Connecting your email

Chalie reads email over IMAP and sends over SMTP. Most email providers support both protocols out of the box.

Step by step

  1. Open the Brain panel (the ⚙️ icon in the sidebar)
  2. Switch to the Capabilities tab
  3. Find Email and toggle it on
  4. Fill in your IMAP settings (for reading):
    • Server — your provider’s IMAP hostname
    • Port — usually 993 (SSL) or 143 (STARTTLS)
    • Username — typically your full email address
    • Password — your email password or app-specific password
  5. Fill in your SMTP settings (for sending):
    • Server — your provider’s SMTP hostname
    • Port — usually 587 (STARTTLS) or 465 (SSL)
    • Username and Password — same as IMAP in most cases
  6. Click Test Connection to verify everything works

Common provider settings

Provider IMAP Server IMAP Port SMTP Server SMTP Port
Gmail imap.gmail.com 993 smtp.gmail.com 587
Outlook / Microsoft 365 outlook.office365.com 993 smtp.office365.com 587
Fastmail imap.fastmail.com 993 smtp.fastmail.com 587
iCloud imap.mail.me.com 993 smtp.mail.me.com 587
Yahoo Mail imap.mail.yahoo.com 993 smtp.mail.yahoo.com 587

Gmail users

Gmail requires an App Password instead of your regular Google password. To generate one:

  1. Go to myaccount.google.com
  2. Navigate to Security → 2-Step Verification → App passwords
  3. Create a new app password for “Mail”
  4. Use the generated 16-character password in Chalie’s email settings

Your regular Gmail password will not work with IMAP.

Troubleshooting

  • Connection refused — double-check the server hostname and port number
  • Authentication failed — verify your username (usually your full email address) and password; Gmail users need an App Password
  • IMAP not enabled — some providers require you to enable IMAP access in their settings (Gmail: Settings → Forwarding and POP/IMAP)
  • Timeout errors — check that your firewall or network allows outbound connections on ports 993 and 587