Read and manage emails via IMAP protocol. List, read, search, and download email attachments. Supports digest mode for daily briefings. Triggers: check email...
---
name: imap-mailbox
description: "Read and manage emails via IMAP protocol. List, read, search, and download email attachments. Supports digest mode for daily briefings. Triggers: check email, read inbox, new mail, email digest."
---
# 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
don't have the plugin yet? install it then click "run inline in claude" again.