IMAP Mailbox
/install imap-mailbox
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 \x3Cuid>
Read the full content of the email with the specified UID.
Search Emails
imap-mailbox search \x3Ckeyword>
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 \x3Cuid> [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": "[email protected]",
"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
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install imap-mailbox - After installation, invoke the skill by name or use
/imap-mailbox - Provide required inputs per the skill's parameter spec and get structured output
What is IMAP Mailbox?
Read and manage emails via IMAP protocol. List, read, search, and download email attachments. Supports digest mode for daily briefings. Triggers: check email... It is an AI Agent Skill for Claude Code / OpenClaw, with 58 downloads so far.
How do I install IMAP Mailbox?
Run "/install imap-mailbox" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is IMAP Mailbox free?
Yes, IMAP Mailbox is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does IMAP Mailbox support?
IMAP Mailbox is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created IMAP Mailbox?
It is built and maintained by Shimon Xin (@shimonxin); the current version is v1.0.1.