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, "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.
What agents get
Section titled “What agents get”When a Mail integration is granted to the running profile, the agent gets a mail MCP server (mcp__mail__*):
| Tool | What it does |
|---|---|
mail_list_folders | List mailbox folders. |
mail_search | Search a folder (default INBOX) by text, sender, subject, unread, or date. Newest first, max 50. |
mail_read_message | Read one message by UID. |
mail_create_draft | Save a draft without sending it. Agents are told to prefer this unless you explicitly asked them to send. |
mail_send | Send a message (optionally as a reply). Blocked when allow_send is off. |