Email - PraisonAI

Give your agents the ability to send and read emails. Two backends available — choose one or both.

Quick Start

AgentMail (API)
SMTP/IMAP (Gmail, Outlook, etc.)

Zero-config email via the AgentMail API. No IMAP/SMTP setup.

from praisonaiagents import Agent
from praisonaiagents.tools import send_email, list_emails, read_email

agent = Agent(
    name="EmailAgent",
    instructions="You help send and manage emails.",
    tools=[send_email, list_emails, read_email]
)

agent.start("Send an email to bob@example.com about tomorrow's meeting")

export AGENTMAIL_API_KEY="am_..."
export AGENTMAIL_INBOX_ID="you@agentmail.to"

Use your own mailbox credentials — works with any email provider.

from praisonaiagents import Agent
from praisonaiagents.tools import smtp_send_email, smtp_read_inbox

agent = Agent(
    name="EmailAgent",
    instructions="You help send and manage emails.",
    tools=[smtp_send_email, smtp_read_inbox]
)

agent.start("Send an email to bob@example.com about tomorrow's meeting")

export EMAIL_ADDRESS="you@gmail.com"
export EMAIL_PASSWORD="xxxx xxxx xxxx xxxx"  # App Password

Using Tool Profiles

Instead of importing individual tools, use built-in profiles:

from praisonaiagents import Agent
from praisonaiagents.tools import resolve_profiles

# AgentMail tools
agent = Agent(
    name="EmailAgent",
    instructions="Handle emails",
    tools=resolve_profiles("email")   # send_email, list_emails, read_email
)

# SMTP/IMAP tools
agent = Agent(
    name="EmailAgent",
    instructions="Handle emails",
    tools=resolve_profiles("smtp_email")  # smtp_send_email, smtp_read_inbox
)

Available Tools

AgentMail Tools

Requires: pip install agentmail + AGENTMAIL_API_KEY

Tool	Description
`send_email(to, subject, body)`	Send an email to a recipient
`list_emails(limit=10)`	List recent emails in the inbox
`read_email(message_id)`	Read full content of a specific email
`list_inboxes()`	List all inboxes for this API key

SMTP/IMAP Tools

Requires: EMAIL_ADDRESS + EMAIL_PASSWORD (no extra packages)

Tool	Description
`smtp_send_email(to, subject, body)`	Send email via SMTP
`smtp_read_inbox(limit=10, folder="INBOX")`	Read recent emails via IMAP

SMTP/IMAP tools auto-detect server settings for Gmail, Outlook, Yahoo, and iCloud. Override with EMAIL_SMTP_SERVER / EMAIL_IMAP_SERVER if needed.

YAML Configuration

# agentmail-bot.yaml
agent:
  name: "Email Assistant"
  instructions: "Handle emails concisely"
  model: "gpt-4o-mini"
  tools:
    - send_email
    - list_emails
    - read_email

praisonai bot start --config agentmail-bot.yaml

Environment Variables

Variable	Backend	Default	Description
`AGENTMAIL_API_KEY`	AgentMail	—	API key from agentmail.to
`AGENTMAIL_INBOX_ID`	AgentMail	—	Inbox email address
`EMAIL_ADDRESS`	SMTP/IMAP	—	Your email address
`EMAIL_PASSWORD`	SMTP/IMAP	—	App Password (recommended)
`EMAIL_SMTP_SERVER`	SMTP/IMAP	Auto-detected	SMTP server hostname
`EMAIL_IMAP_SERVER`	SMTP/IMAP	Auto-detected	IMAP server hostname

Gmail Setup

Enable 2-Factor Authentication
Generate App Password at Google Account
Use App Password as EMAIL_PASSWORD

Email Bot

Deploy always-on email bots with polling

Messaging Bots

All supported messaging platforms

Tools

Other Features

​Quick Start

​Using Tool Profiles

​Available Tools

​AgentMail Tools

​SMTP/IMAP Tools

​YAML Configuration

​Environment Variables

​Gmail Setup

​Related

Email Bot

Messaging Bots

Quick Start

Using Tool Profiles

Available Tools

AgentMail Tools

SMTP/IMAP Tools

YAML Configuration

Environment Variables

Gmail Setup

Related