llamaindex-multimail 0.1.0

LlamaIndex tools for MultiMail -- give your LlamaIndex agents email capabilities

llamaindex-multimail

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

Tool	Description
send_email	Send an email (held for approval if gated)
check_inbox	List recent emails in a mailbox
read_email	Read the full content of an email
reply_email	Reply to an existing email thread
search_contacts	Search contacts by name or email
list_pending	List emails awaiting human approval
decide_email	Approve or reject a pending email
get_thread	Get all emails in a conversation
tag_email	Add tags to an email for classification

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