email-microsoft

name	email-microsoft
description	Full email client via Mac Mail.app — read, search, send, reply, manage across all accounts
allowed-tools	Bash, Read, Write, Glob, Grep

Email — Mac Mail.app

Full email client via JXA. Zero network calls for reading. Sends via Mail.app.

Setup

cd /Users/chensijie/Projects/claude-secretary && source venv/bin/activate

Reading

python scripts/mac_mail.py inbox                                    # all accounts unread
python scripts/mac_mail.py list --account Stanford --top 10         # recent
python scripts/mac_mail.py list --account Stanford --unread         # unread only
python scripts/mac_mail.py list --account Stanford --date 2025-12-31  # specific date
python scripts/mac_mail.py list --account Stanford --preview        # with body snippet
python scripts/mac_mail.py read MAIL_ID --account Stanford          # full content

Search

python scripts/mac_mail.py search "keyword" --account Stanford --top 10

Send & Reply

python scripts/mac_mail.py send --to [e-mail] --subject "Subject" --body "Body" --account Stanford
python scripts/mac_mail.py send --to [e-mail] [e-mail] --cc [e-mail] --subject "Hi" --body "Hello" --account Stanford
python scripts/mac_mail.py reply MAIL_ID --body "Reply text" --account Stanford
python scripts/mac_mail.py reply MAIL_ID --body "Reply text" --account Stanford --all

IMPORTANT: Always confirm with the user before sending. Show them the recipient, subject, and body for approval first.

Manage

python scripts/mac_mail.py mark read 12345 --account Stanford
python scripts/mac_mail.py mark unread 12345 67890 --account Stanford

Tasks (from emails)

python scripts/tasks.py add "Task title" --due 2026-04-08 --priority high --from-email 54443
python scripts/tasks.py list --status todo
python scripts/tasks.py done 1

Accounts

Stanford, Gmail, 清华校友, Outlook. Default to Stanford.

TUI

Interactive terminal UI: ./mail (run in Terminal.app, not here)