IMAP Mailbox

Read and manage emails via the IMAP protocol.

Use Cases

• User asks to check email, view inbox, or read email content
• User asks to search emails (by sender, subject, etc.)
• User asks to mark emails as read/unread
• Daily email digest / briefing

Commands

List Recent Emails

imap-mailbox list [limit]

Lists summaries (sender, subject, date) of the most recent emails. Default: 10.

Read Email Content

imap-mailbox read <uid>

Read the full content of the email with the specified UID.

Search Emails

imap-mailbox search <keyword>

Search emails where the subject or sender contains the keyword.

Email Digest

imap-mailbox digest

Generate a daily email digest summary — categorized and condensed for quick review.

Download Attachments

imap-mailbox download <uid> [output-dir]

Download attachments from the specified email to the output directory.

Configuration

Config file located at ~/.config/imap-mailbox/config.json, containing email address, IMAP server, and authorization token.

{
  "email": "user@example.com",
  "host": "imap.example.com",
  "port": 993,
  "token": "your-authorization-code"
}

Security Notes

• Authorization tokens are stored locally and never uploaded
• Recommend rotating authorization tokens periodically
• To revoke access, regenerate the authorization code in your email provider settings