LangChain + AgentMail

Official AgentMail integration for LangChain. Give your AI agents the ability to create email inboxes, send and receive emails, and automate email-based workflows like OTP verification.

Install

pip install langchain-agentmail

Quick Start

from langchain_agentmail import AgentMailToolkit

# Uses AGENTMAIL_API_KEY env var by default
toolkit = AgentMailToolkit()
tools = toolkit.get_tools()

Create an Inbox

result = tools[0].invoke({"name": "test-inbox"})  # CreateInbox
print(result)  # {"inbox_id": "...", "email": "..."}

Send and Read Emails

# Send an email
tools[1].invoke({"to": "user@example.com", "subject": "Hello", "body": "Hi there!", "from": "inbox_abc123"})

# Wait for a reply (blocks up to 60s)
msg = tools[6].invoke({"inbox_id": "inbox_abc123", "timeout": 60})

Use with a LangGraph Agent

from langgraph.prebuilt import create_react_agent
from langchain_openai import ChatOpenAI
from langchain_agentmail import AgentMailToolkit

toolkit = AgentMailToolkit()
agent = create_react_agent(ChatOpenAI(model="gpt-4o-mini"), toolkit.get_tools())

result = agent.invoke({"messages": [{"role": "user", "content": "Create an inbox and wait for a verification email"}]})

See example.py for a full OTP-automation agent.

Environment Variables

Tools

License

MIT