email-assistant

name	email-assistant
description	Read, search, draft, and send emails via Himalaya CLI or Python IMAP/SMTP. Requires email account configuration.
version	1.0.0
metadata	{"echo":{"tags":["Email","IMAP","SMTP","Himalaya","Productivity"],"requires":{"anyBins":["himalaya","python3"]}}}

Email Assistant

Two options: Himalaya CLI (modern, Rust-based) or Python imaplib fallback.

Option A: Himalaya (Recommended)

brew install himalaya  # or cargo install himalaya
himalaya account configure

Read

himalaya envelope list
himalaya envelope list --folder INBOX --page-size 10
himalaya message read <id>

Search

himalaya envelope list --folder INBOX subject "weekly report"
himalaya envelope list from "[e-mail]"

Send

himalaya message write
# Or via template:
himalaya template write | himalaya message send

Reply/Forward

himalaya message reply <id>
himalaya message forward <id>

Option B: Python Fallback

Environment variables:

export ECHO_EMAIL_HOST=imap.gmail.com
export ECHO_EMAIL_USER=[e-mail]
export ECHO_EMAIL_PASS=app-password
export ECHO_SMTP_HOST=smtp.gmail.com
export ECHO_SMTP_PORT=587

python3 scripts/email_client.py list --host imap.example.com --user [e-mail] --password xxx --count 10
python3 scripts/email_client.py search --host imap.example.com --user [e-mail] --password xxx "urgent"
python3 scripts/email_client.py send --smtp-host smtp.example.com --user [e-mail] --password xxx --to "[e-mail]" --subject "Hi" --body "Content"

Common Workflows

• Morning email digest: fetch unread, summarize subjects
• Draft reply: compose response based on context
• Search by sender/date/subject

Security

• Store credentials in environment variables, never in chat
• Use app-specific passwords (Gmail requires this)
• Consider OAuth2 for production use