Skip to content
TakoAPI
Back to skills

imap-idle

by topitip

Web & Frontend Development
1.4kDownloads reported by clawskills.sh
3Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Event-driven email monitoring using IMAP IDLE protocol.

Description

What This Skill Does

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.

When to Use It

  • 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

Example Workflow

INPUT

User asks: notify me when a new email arrives

AGENT
  1. 1

    Opens persistent IMAP connection to the configured account

  2. 2

    Enters IDLE mode so the server can push notifications

  3. 3

    Receives server push when new mail arrives

  4. 4

    Fetches email headers and body preview

  5. 5

    Sends batched event via webhook to wake OpenClaw

OUTPUT

OpenClaw receives the webhook and processes the incoming email immediately

Requirements

  • IMAP account credentials (host, port, username, password)

Installation

clawhub install topitip/imap-idle

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links