crewai-multimail

⚠️ DEPRECATED (2026-08-08). This package is retired and will receive no further updates. MultiMail's supported integration surfaces are the MCP server at https://mcp.multimail.dev (LangChain, CrewAI, LlamaIndex, Claude, and all MCP-capable frameworks connect natively) and the REST API (https://multimail.dev/docs). This final release only adds this deprecation notice.

CrewAI tools for MultiMail — give your CrewAI agents email capabilities with graduated human oversight.

Installation

pip install crewai-multimail

Quick Start

from crewai import Agent, Task, Crew
from crewai_multimail import MultiMailToolkit

# Create tools from your API key
toolkit = MultiMailToolkit(api_key="mm_live_your_api_key")
tools = toolkit.get_tools()

# Create an agent with email capabilities
email_agent = Agent(
    role="Email Assistant",
    goal="Help the user manage their email inbox",
    backstory="You are a helpful email assistant that reads, triages, and drafts replies.",
    tools=tools,
    verbose=True,
)

# Define a task
task = Task(
    description="Check mailbox YOUR_MAILBOX_ID for new emails and summarize them.",
    expected_output="A summary of recent emails with sender, subject, and urgency.",
    agent=email_agent,
)

# Run the crew
crew = Crew(agents=[email_agent], tasks=[task], verbose=True)
result = crew.kickoff()
print(result)

Available Tools

Oversight Modes

MultiMail supports graduated oversight so your agent doesn't send unsupervised email:

• gated_all — Agent drafts, human approves everything
• gated_send — Agent reads freely, human approves outbound (default)
• monitored — Agent sends, human can review after
• autonomous — Full agent control

When a mailbox uses gated oversight, send_email returns pending_send_approval and the email waits for human review. The agent can check status with list_pending.

Using Individual Tools

from multimail import MultiMail
from crewai_multimail import CheckInboxTool, SendEmailTool

client = MultiMail("mm_live_your_api_key")

inbox_tool = CheckInboxTool(client=client)
send_tool = SendEmailTool(client=client)

# Use directly
result = inbox_tool.run(mailbox_id="your_mailbox_id", limit=5)
print(result)

Multi-Agent Crew Example

See examples/support_crew.py for a full example with a triage agent and a responder agent working together as a crew.

Links

• MultiMail — Homepage & docs
• multimail — Base Python SDK
• MCP Server — For Claude, Cursor, and other MCP clients