AgentMail Setup_

Enable your agent to send and receive emails. Perfect for notifications, digests, and forwarding external data into your workflow. Your agent gets a dedicated inbox like your-project@agentmail.to.

What It Does

AgentMail gives your agent a dedicated inbox at zoe@agentmail.to (or similar). The agent can:

• Send emails on your behalf
• Receive and read incoming messages
• Generate digests of newsletters or external data
• Forward important messages for processing

Installation Steps

1. Get an API Key

Visit agentmail.to and sign up for a free account. Generate an API key from your dashboard.

2. Store the Key in .env

Add this line to your workspace .env file:

3. Test the Connection

Ask your agent to send a test email:

Check that it arrives in a few seconds.

4. Set Up Incoming Email Forwarding (Optional)

If you want external emails forwarded to your agent, configure forwarding rules in the AgentMail dashboard to route them to your agent's workspace.

Verification

Successful setup means:

• Test email arrives at your address
• Your agent can read responses from the AgentMail inbox
• You see confirmation logs in the agent's session history

Troubleshooting

• API key not recognized: Verify the key is correctly stored in .env and reload the agent session.
• Email not sending: Check that you're connected to the internet and the AgentMail service is live.
• Emails going to spam: Whitelist agentmail.to in your email provider.