AutoGen + AgentMail

Official AgentMail integration for AutoGen / AG2. Give your agents real email inboxes — send, receive, reply, forward, and organize messages via the AgentMail API.

Install

pip install autogen-agentmail

Quick Start

1. Set your API key

export AGENTMAIL_API_KEY=your_key_here

2. Create an inbox for your agent

from autogen_agentmail import create_inbox

inbox = create_inbox(name="My Agent")
print(inbox["email"])  # e.g. agent-abc123@agentmail.to

3. Send an email

from autogen_agentmail import send_email

send_email(
    to="bob@example.com",
    subject="Hello from my agent",
    body="This is an automated message.",
    from_inbox_id=inbox["id"],
)

4. Wait for a reply

from autogen_agentmail import wait_for_message

msg = wait_for_message(inbox_id=inbox["id"], timeout=60)
print(msg["body"])

5. Register all tools with an AutoGen agent

import autogen
from autogen_agentmail import register_agentmail_tools

agent = autogen.ConversableAgent(
    name="EmailBot",
    llm_config={"config_list": [{"model": "gpt-4o"}]},
)

register_agentmail_tools(agent)
# Agent can now create_inbox, send_email, list_messages, etc.

Available Tools

Example

See example.py for a full demo of two agents communicating via email with inboxes, send, wait, and cleanup.

Configuration

License

MIT