← All channels

Email

stable

IMAP in, SMTP out · threads kept intact.

In
Out
Auth
IMAP/SMTP creds
§ Required environment

Env vars

IRIS_EMAIL_IMAP_URL
Required

imaps://user:pass@host:993 connection string.

IRIS_EMAIL_SMTP_URL
Required

smtps://user:pass@host:465 connection string.

IRIS_EMAIL_FROM
Required

From address the agent sends as.

§ Setup

Step by step

  1. 01

    Pick a mailbox

    Create or pick an existing mailbox the agent will own. App-specific passwords are strongly recommended over your main credentials.

  2. 02

    Export connection strings

    Provide IMAP for inbound and SMTP for outbound.

    export IRIS_EMAIL_IMAP_URL="imaps://iris%40example.com:app-pass@imap.example.com:993"
    export IRIS_EMAIL_SMTP_URL="smtps://iris%40example.com:app-pass@smtp.example.com:465"
    export IRIS_EMAIL_FROM="iris@example.com"
  3. 03

    Enable the channel

    Iris.Md will start polling IMAP every 30s.

    iris channels enable email
§ Success

You're done when

  • Test email to the mailbox shows up in iris logs
  • Reply from the agent threads correctly
  • iris channels list shows email: ok