---
name: email
description: "Email — dedicated email account. Retrieval: email-graph-query for stored email history, recall, and search ('what emails are in memory?', 'emails about X', 'what did Y send?'); email-read / email-search for live IMAP inbox. Sending: email-send (new), email-reply (threaded). Config: email-setup, email-status, email-auto-respond-config, email-otp-extract."
tools:
  - email-setup
  - email-read
  - email-send
  - email-reply
  - email-search
  - email-graph-query
  - email-otp-extract
  - email-status
  - email-auto-respond-config
always: false
embed: ["admin"]
metadata: {"platform":{"optional":true,"recommended":true}}
---

# Email

Manages the agent's own dedicated email account — IMAP for reading, SMTP for sending. Admin agent only.

## Capabilities

- **Setup:** `email-setup` — collect credentials via rendered `form`, connect IMAP/SMTP. Supports alias addresses (`agentAddress`).
- **Read inbox:** `email-read` — metadata only (UID, sender, subject, date). Supports pagination (`before_uid`), folders (`inbox`/`sent`), filtering by sender/date/subject.
- **Search inbox:** `email-search` — live IMAP search by sender, subject, body keyword, date range.
- **Send:** `email-send` — new outbound email.
- **Reply:** `email-reply` — threaded reply to an existing email by `messageId`. Supports `replyAll`.
- **Recall/history:** `email-graph-query` — search stored emails in Neo4j by natural language, sender, date, direction.
- **Status:** `email-status` — connection health and configuration state.
- **Auto-respond:** `email-auto-respond-config` — enable/disable automated public agent replies to inbound email.
- **OTP:** `email-otp-extract` — poll for verification codes during service authentication.

## Retrieval paths

- **Live inbox** (`email-read`, `email-search`) — real-time IMAP queries. Use for checking the inbox or reading recent messages.
- **Graph history** (`email-graph-query`) — stored Email nodes in Neo4j. Use for recall, semantic search, email history questions.
- **General knowledge** (`memory-search`) — cross-type knowledge graph. Use when the question spans all memory, not just emails.

## References

| Reference | Topics |
|-----------|--------|
| [email-reference.md](references/email-reference.md) | Setup form fields, pagination, filtering, replying, alias support, persistence, threading, screening, auto-respond, rate limiting, OTP integration |

Load the reference via `plugin-read` when detailed configuration or behaviour information is needed.
