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