AgentMail

Email via AgentMail

AgentMail gives your agents their own email addresses. They can send and receive email autonomously — replies are routed back to the right agent in real time via WebSocket.

1. Create an AgentMail Account

Sign up at agentmail.to and create an API key from the dashboard.

2. Create Inboxes

Create an inbox for each agent that needs email. You can do this from the AgentMail dashboard or via their API. Each inbox gets a unique email address (e.g. general@agentmail.to).

3. Configure Praktor

Add the API key to your .env:

AGENTMAIL_API_KEY=your-api-key-here

Then assign inbox addresses to agents in config/praktor.yaml:

agentmail:
  api_key: ${AGENTMAIL_API_KEY}

agents:
  general:
    description: "General-purpose assistant"
    agentmail_inbox_id: "general@agentmail.to"
  coder:
    description: "Software engineering specialist"
    agentmail_inbox_id: "coder@agentmail.to"

The gateway connects to AgentMail via WebSocket on startup. When an email arrives, it's dispatched to the agent whose agentmail_inbox_id matches the recipient address.