Email Plugin

The email plugin adds SMTP send and IMAP read/search capabilities to the tool graph. Once configured, any agent can send emails, read your inbox, and search messages.

---

Tools Added

Tool	Description
email_send	Send an email via SMTP
email_read	Read a specific message by ID
email_search	Search inbox with filters
email_list	List recent messages from a folder

---

Configuration

Create ~/.daemi/plugin_config/email.json:

{
  "smtp_host": "smtp.gmail.com",
  "smtp_port": 587,
  "smtp_use_tls": true,
  "imap_host": "imap.gmail.com",
  "imap_port": 993,
  "username": "you@gmail.com",
  "password": "your-app-password",
  "from_name": "Your Name",
  "default_folder": "INBOX"
}

Fields

Field	Required	Default	Description
smtp_host	✓	—	SMTP server hostname
smtp_port	✓	—	SMTP port (587 for STARTTLS, 465 for SSL)
smtp_use_tls		true	Enable STARTTLS
imap_host	✓	—	IMAP server hostname
imap_port		993	IMAP port
username	✓	—	Email address / login
password	✓	—	Password or app-specific password
from_name		username	Display name for sent emails
default_folder		"INBOX"	Default IMAP folder for read/search

---

Gmail Setup

Gmail requires an App Password — you cannot use your regular Google account password.

Steps to generate an App Password:

1. Go to your Google Account
2. Navigate to Security → 2-Step Verification (must be enabled)
3. Scroll down to App passwords
4. Select Mail and your device → Generate
5. Copy the 16-character password into your config

{
  "smtp_host": "smtp.gmail.com",
  "smtp_port": 587,
  "smtp_use_tls": true,
  "imap_host": "imap.gmail.com",
  "imap_port": 993,
  "username": "you@gmail.com",
  "password": "abcd efgh ijkl mnop"
}

tip

Use the app password exactly as Google generates it (with spaces is fine — DAEMI strips them).

---

Usage

Once configured, agents can send email naturally:

"Send an email to kevin@example.com summarizing today's research findings."

Or via tool call in a workflow step:

{
  "tool": "email_send",
  "params": {
    "to": "kevin@example.com",
    "subject": "Research Summary",
    "body": "Summary content here"
  }
}

Searching email:

"Search my inbox for anything from Anthropic in the last 7 days."

email_search supports:

{
  "tool": "email_search",
  "params": {
    "from": "anthropic.com",
    "since": "7d",
    "limit": 10
  }
}

---

Other Email Providers

Provider	SMTP Host	IMAP Host	Notes
Gmail	smtp.gmail.com:587	imap.gmail.com:993	Requires App Password
Outlook/Hotmail	smtp.office365.com:587	outlook.office365.com:993	Use account password or OAuth
FastMail	smtp.fastmail.com:587	imap.fastmail.com:993	App password recommended
Custom/Self-hosted	Your server	Your server	Depends on your config

---

Go Deeper

→ Plugin Configuration

General plugin setup flow and security notes.

→ Workflows

Use email_send in automated workflows.