llamaindex-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.

LlamaIndex tools for MultiMail -- give your LlamaIndex agents email capabilities with graduated human oversight.

Installation

pip install llamaindex-multimail

Quick Start

from llama_index.core.agent import ReActAgent
from llama_index.llms.openai import OpenAI
from llamaindex_multimail import MultiMailToolSpec

# Create tools from your API key
tool_spec = MultiMailToolSpec(api_key="mm_live_your_api_key")
tools = tool_spec.to_tool_list()

# Create agent
llm = OpenAI(model="gpt-4o")
agent = ReActAgent.from_tools(tools, llm=llm, verbose=True)

# Run
response = agent.chat("Check mailbox 'mbx_123' for new emails")
print(response)

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 with Other LlamaIndex Patterns

The MultiMailToolSpec follows the standard LlamaIndex BaseToolSpec pattern, so it works with any agent framework that accepts LlamaIndex tools:

from llamaindex_multimail import MultiMailToolSpec

spec = MultiMailToolSpec(api_key="mm_live_your_api_key")

# Get all tools
tools = spec.to_tool_list()

# Or get a specific tool
send_tool = spec.to_tool_list(func_to_metadata_mapping={
    "send_email": {"name": "send_email", "description": "Send an email"},
})

Links

• MultiMail -- Homepage & docs
• multimail -- Base Python SDK
• langchain-multimail -- LangChain integration
• MCP Server -- For Claude, Cursor, and other MCP clients