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#

bash

imap-mailbox list [limit]

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

Read Email Content#

bash

imap-mailbox read <uid>

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

Search Emails#

bash

imap-mailbox search <keyword>

Search emails where the subject or sender contains the keyword.

Email Digest#

bash

imap-mailbox digest

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

Download Attachments#

bash

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.

json

{
  "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