OpenParable
Skip to content
← Back to skills

Email Assistant

Apps & Automation
email-assistant

Email Assistant is an Agent Skill for apps & automation published in the fuyuxiang/echo-agent repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Read, search, draft, and send emails via Himalaya CLI or Python IMAP/SMTP. Requires email account configuration.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/fuyuxiang/echo-agent/blob/HEAD/skills/productivity/email-assistant/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/email-assistant, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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 "[email protected]"

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 [email protected]
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 [email protected] --password xxx --count 10
python3 scripts/email_client.py search --host imap.example.com --user [email protected] --password xxx "urgent"
python3 scripts/email_client.py send --smtp-host smtp.example.com --user [email protected] --password xxx --to "[email protected]" --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