CrewAI + AgentMail

Official AgentMail integration for CrewAI. Give your CrewAI agents real email inboxes — send, receive, reply, search, and organize emails as tools.

Install

pip install crewai-agentmail

Quick Start

from crewai import Agent
from crewai_agentmail import AgentMailTools

# Initialize with API key (or set AGENTMAIL_API_KEY env var)
toolkit = AgentMailTools(api_key="am_live_...")

# Add all 11 tools to an agent
agent = Agent(
    role="Email Assistant",
    goal="Manage email communications",
    tools=toolkit.get_tools(),
)

Create an Inbox & Send Email

# Individual tools
from crewai_agentmail import CreateInbox, SendEmail

create = CreateInbox(api_key="am_live_...")
print(create._run(name="Support Agent"))  # → inbox ID + email

send = SendEmail(api_key="am_live_...")
print(send._run(to="user@example.com", subject="Hello", body="Hi there!"))

Wait for Replies

from crewai_agentmail import WaitForMessage

wait = WaitForMessage(api_key="am_live_...")
print(wait._run(inbox_id="inbox_123", timeout=120))

Search & Label

from crewai_agentmail import SearchMessages, CreateLabel, ApplyLabel

search = SearchMessages(api_key="am_live_...")
print(search._run(inbox_id="inbox_123", query="urgent"))

label = CreateLabel(api_key="am_live_...")
print(label._run(name="Follow-Up", color="#FF5733"))

Environment Variables

Available Tools

Example

See example.py for a full CrewAI crew with a Sales Rep agent that creates an inbox, sends outreach, waits for replies, and cleans up.

License

MIT