imap-idle
par topitip
Web & Frontend DevelopmentRésumé
Event-driven email monitoring using IMAP IDLE protocol.
Description
Ce que fait ce skill
IMAP IDLE replaces scheduled email polling with a persistent server connection that pushes notifications when new mail arrives. Latency drops from up to an hour to under a second, and no tokens are consumed while waiting.
Unlike cron-based email checks that burn tokens on every empty poll, IMAP IDLE consumes zero tokens while idle and delivers sub-second notifications.
Quand l'utiliser
- Replacing hourly cron email checks with instant notifications
- Processing customer support emails as they arrive
- Monitoring multiple email accounts from one listener
- Triggering workflows the moment a specific email lands
- Cutting token costs from empty polling runs
Exemple de workflow
User asks: notify me when a new email arrives
- 1
Opens persistent IMAP connection to the configured account
- 2
Enters IDLE mode so the server can push notifications
- 3
Receives server push when new mail arrives
- 4
Fetches email headers and body preview
- 5
Sends batched event via webhook to wake OpenClaw
OpenClaw receives the webhook and processes the incoming email immediately
Prérequis
- IMAP account credentials (host, port, username, password)
Installation
clawhub install topitip/imap-idleExécute la commande CLI, ou colle l'instruction dans Claude Code, Cursor, Codex ou l'agent de code que tu utilises.