Email-Capable Phidata Agents with Oversight

Give Phidata agents full email capabilities through MultiMail — with graduated trust modes that let you start with human approval and progress to autonomous.


Phidata is a framework for building AI agents with memory, knowledge, and tools. Its agent teams can include specialists for different tasks — research, analysis, communication. MultiMail provides the email tool layer for communication agents, with oversight modes that match Phidata's philosophy of building trustworthy AI systems.

By integrating MultiMail as a Phidata tool, your agents can send emails, check inboxes, manage contacts, and track threads. The default gated_send mode means the email agent in your team drafts messages but a human approves before delivery, building trust incrementally.

Integration is simple: define a custom Phidata tool class that wraps MultiMail REST API calls, then assign it to any agent that needs email capabilities.

Built for Phidata developers

Team-Based Email Responsibilities

Phidata's agent teams can include a dedicated email agent alongside research and analysis agents. MultiMail provides the email infrastructure while oversight modes ensure the email agent can't send without authorization.

Knowledge-Enhanced Email Composition

Phidata agents with knowledge bases can compose emails informed by domain-specific context. MultiMail handles delivery with oversight, ensuring knowledge-driven emails are reviewed before reaching recipients.

Memory-Aware Email Handling

Phidata's memory features let agents recall past interactions. Combined with MultiMail's thread tracking, agents can draft replies that reference both their memory and the actual email thread history.

Simple Tool Integration

Phidata's tool system maps directly to MultiMail's API. Define a tool class with methods for each email operation, and the agent can invoke them naturally during conversations.


Try it with your agent

No code, no dashboard. Paste this to your AI agent — it connects MultiMail, creates an inbox, and builds the flow for you.

1. Read https://multimail.dev/llms.txt first, then connect the MultiMail MCP server exactly as documented there. Use the MCP tools to create a free inbox, configure a verified sending domain, and keep the inbox oversight mode set to gated_send. 2. Wire MultiMail into this Phidata agent through Phidata’s MCP integration: create an MCPTools connection for the MultiMail MCP server and pass that connected MCPTools instance into the Agent tools list, the same way Phidata agents receive external toolkits and callable tools. 3. Give the agent only these email capabilities from MultiMail: check the inbox for recent messages, compose a draft reply for review, send approved email, and schedule email when explicitly requested. Do not use any direct HTTP calls or undocumented endpoints. 4. Send one test email from the verified sender to the developer’s own address with a short subject and body confirming that the Phidata agent can send through MultiMail. 5. Run the test in gated_send mode so the send request pauses for developer review before delivery. After the developer approves it, confirm the message was sent; leave the agent in gated_send until the developer intentionally changes oversight to monitored or autonomous.

Step by step

1

Create a MultiMail Account and API Key

Sign up at multimail.dev, create a mailbox, and generate an API key from your dashboard. Your key will start with mm_live_.

2

Install Dependencies

Install Phidata and the HTTP library for calling the MultiMail API.

3

Create the MultiMail Toolkit

Define a Phidata Toolkit class with methods for each MultiMail API operation. Register each method so the agent can discover and invoke it.

4

Build Your Email Agent

Create a Phidata Agent with the MultiMail toolkit and instructions explaining the oversight mode. Add it to a team if needed.

5

Approve Pending Emails

Review emails queued by your Phidata agent in the MultiMail dashboard. Approve or reject before delivery.


Common questions

Can Phidata agent teams share email access?
Yes, but it's better to limit email tools to one designated agent in the team. The team coordinator delegates email tasks to the email agent, which has the MultiMail toolkit. This prevents multiple agents from sending duplicate or conflicting emails.
How does Phidata's memory work with email threads?
Phidata's memory records past interactions, including email tool invocations. When handling a returning contact, the agent can recall previous email exchanges. For authoritative thread history, use the get_thread tool to retrieve the actual email thread from MultiMail.
Can I use Phidata's knowledge base to compose emails?
Yes. A Phidata agent with both a knowledge base and MultiMail tools can compose emails informed by domain-specific knowledge. The agent retrieves relevant information from the knowledge base and incorporates it into email drafts. Gated_send ensures the human reviews the final composition.
What oversight mode should I start with?
Start with gated_send, the default. This lets your agent read emails freely but requires human approval for every outbound send. As you build confidence in the agent's email composition quality, you can progress to monitored (sends go through, but are logged) and eventually autonomous.

Explore more

The only agent email with a verifiable sender

Email infrastructure built for AI agents. Verifiable identity, graduated oversight, and a hosted MCP server. Formally verified in Lean 4.