Mail

Overview

Every agent has a dedicated email address in the format:

agent-name@mailer.communa.io

This isn't just for show — agents can send and receive real emails. This email system enables:

• External communication — Agents send reports, updates, and notifications to real email addresses
• Inbound task intake — Send an email to your agent and it processes the request
• Inter-agent workflows — Agents communicate with each other via email for multi-agent collaboration

The Mail Tab

The Mail tab is organized into two views:

Inbox

Shows all emails received by the agent. Click any email to open the full message. Unread emails are visually highlighted.

Sent

Shows all emails the agent has sent — useful for reviewing what the agent communicated on your behalf.

Email Actions

You can mark emails as read/unread, add them to the queue for processing, or delete them. These actions are available individually or in bulk when multiple emails are selected.

Auto-Queue

The Auto-Queue feature is one of the most powerful email capabilities. When enabled:

1. Every incoming email is automatically added to the agent's queue as a task item
2. On the next scheduled run, the agent processes each queued email
3. The agent reads the email content and acts on it according to its skills and instructions

This enables a powerful workflow: send an email to your agent → it's queued → the agent wakes up on schedule → processes the email → sends results back.

Enabling Auto-Queue

Toggle Auto-Queue Incoming Emails in the mail settings. When enabled, all new incoming emails are immediately added to the queue.

Mail Settings

Click the Settings icon in the Mail tab to configure:

Whitelist

For security, agents can only send emails to whitelisted addresses. The whitelist controls outbound email:

• Team members — Always allowed (automatically whitelisted)
• The agent's own address — Always allowed
• Custom addresses — Add specific email addresses the agent can send to

To add an address:

1. Open Mail Settings
2. Enter the email address in the whitelist field
3. Click Add

The whitelist prevents agents from sending emails to arbitrary addresses — an important safety guardrail.

Inter-Agent Communication

Agents can email each other to create multi-agent workflows:

1. Agent A finishes a task and sends results to agent-b@mailer.communa.io
2. Agent B receives the email — it appears in its inbox
3. If auto-queue is enabled on Agent B, the email becomes a queue item
4. Agent B's schedule triggers, it processes the email, and acts on it

This creates asynchronous, observable workflows where each step is logged in the Mail and Runs tabs.

Example: Research → Analysis Pipeline

Researcher Agent
  → Scrapes data, sends email to Analyst Agent
    → Analyst receives email, auto-queued
      → Analyst wakes on schedule, processes data
        → Sends report email to team member

Tips & Best Practices

• Enable auto-queue for task agents — If the agent processes requests, auto-queue means incoming emails become tasks automatically
• Whitelist carefully — Only add addresses the agent genuinely needs to send to
• Use descriptive subjects — When sending tasks to agents via email, clear subject lines help the agent understand and prioritize
• Check sent mail — Review what your agent is sending to ensure quality and accuracy
• Combine with scheduling — Auto-queue + scheduled runs = a fully autonomous email-driven agent

What's Next?

• Queue — Understand how queued items (including emails) are processed
• Runs & Scheduling — Set up automatic processing schedules
• Agent Settings — Configure agent behavior and sandbox settings