Skip to content

Mail (IMAP/SMTP)

The Mail integration connects one mailbox over standard IMAP (read) and SMTP (send). It works with any provider that offers IMAP/SMTP access — Gmail, Outlook / Microsoft 365, Fastmail, iCloud, or your own server. Credentials are stored encrypted and never reach the agent container.

In the dashboard: Settings → Integrations → Mail → “Connect mailbox”. Pick a preset (Gmail, Outlook, Fastmail, iCloud) or “Custom”, then enter your username and password. For providers with two-factor auth (Gmail, iCloud, Fastmail) use an app password, not your account password.

Vonzio logs in over both IMAP and SMTP before saving — if either fails, you get the error in the dialog and nothing is stored.

API alternative:

POST /v1/integrations
{
"type": "mail",
"config": {
"imap_host": "imap.fastmail.com", "imap_port": 993,
"smtp_host": "smtp.fastmail.com", "smtp_port": 465,
"username": "you@example.com", "password": "app-password",
"security": "tls",
"from_name": "You",
"allow_send": true
}
}

security is tls (default) or starttls. Set allow_send: false to give agents read and draft access only.

When a Mail integration is granted to the running profile, the agent gets a mail MCP server (mcp__mail__*):

ToolWhat it does
mail_list_foldersList mailbox folders.
mail_searchSearch a folder (default INBOX) by text, sender, subject, unread, or date. Newest first, max 50.
mail_read_messageRead one message by UID.
mail_create_draftSave a draft without sending it. Agents are told to prefer this unless you explicitly asked them to send.
mail_sendSend a message (optionally as a reply). Blocked when allow_send is off.