Agent skill · software engineering · sundial-org
imap-email
Read and manage email via IMAP (ProtonMail Bridge, Gmail, etc.). Check for new/unread messages, fetch content, search mailboxes, and mark as read/unread. Works with any IMAP server including ProtonMail Bridge.
Why this skill is useful
Adds 5 executable scripts for managing emails via IMAP that provide capabilities not commonly found in public documentation.
What it needs
Requires node installed locally. About 3k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
IMAP Email Reader Read, search, and manage email via IMAP protocol. Supports ProtonMail Bridge, Gmail IMAP, and any standard IMAP server. Quick Start Check for new emails: Fetch specific email: Mark as read: Search mailbox: Configuration Create .env in the skill folder or set environment variables: ProtonMail Bridge setup: Install and run ProtonMail Bridge Use 127.0.0.1:1143 for IMAP Password is generated by Bridge (not your ProtonMail password) TLS: Use false (Bridge uses STARTTLS) REJECTUNAUTHORIZED: Set to false (Bridge uses self-signed cert) Gmail IMAP setup: Host: imap.gmail.com Port: 993 TLS: true Enable "Less secure app access" or use App Password REJECTUNAUTHORIZED: Omit or set to true (default) Commands check Check for unread/new emails in mailbox. Options: --limit <n>: Max results (default: 10) --mailbox <name>: Mailbox to check (default: INBOX) --recent <time>: Only show emails from last X time (e.g., 30m, 2h, 7d) Returns JSON array of messages with: uid, from, subject, date, snippet, flags fetch Fetch full email content by UID. Returns JSON with full body (text + HTML). search Search emails with filters. Time format examples: 30m = last 30 minutes 2h = last 2 hours 7d = last 7 days mark-read / mark-unread Mark message(s) as read or unread. list-mailboxes List all available mailboxes/folders. Cron Integration Set up periodic email checking with Clawdbot cron: Inside the isolated session, the agent can run: Workflow Examples Morning email digest: 1. Run check --limit 10 --recent 12h 2. Summarize unread emails from overnight 3. Deliver summary to preferred channel Check recent emails from specific sender: 1. Run search --from "important@company.com" --recent 24h 2. Fetch full content if needed 3. Mark as read after processing Hourly urgent email check: 1. Run search --recent 1h --unseen 2. Filter for important keywords 3. Extract action items 4. Deliver notification if urgent Weekly digest: 1. Run search --recent 7d --limit 20 2. Summarize activity 3. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/imap-email