Inbox Triage Bot

AI-powered email triage via IMAP (himalaya) or Google API. Fetches inbox, classifies messages by urgency, recommends actions, and generates daily markdown digests.

Audits

Pass

Install

openclaw skills install gruted-inbox-triage

inbox-triage-bot

AI email triage — fetch, classify, and report on your inbox.

Quick start

cd ~/.openclaw/workspace/skills/inbox-triage-bot
npm install
EMAIL_BACKEND=himalaya npm run demo

What it does

  • Fetches recent emails via IMAP (himalaya) or Google API
  • Classifies by urgency and category (AI or heuristic)
  • Recommends actions per message
  • Pulls upcoming calendar events
  • Generates markdown daily digest reports

Backends

himalaya (recommended — no OAuth)

Requires himalaya CLI configured with a Gmail App Password:

himalaya envelope list -f INBOX -s 5  # test
EMAIL_BACKEND=himalaya npm run demo

Google API (alternative)

Requires OAuth credentials:

cp .env.example .env  # edit with OAuth creds
npm run google:oauth:init
npm run demo

Commands

npm run demo              # full triage report (markdown)
npm run email:fetch       # raw envelopes (JSON)
npm run email:triage      # classified envelopes (JSON)
npm run calendar:upcoming # upcoming events (JSON)

Environment variables

VariableDefaultDescription
EMAIL_BACKENDautohimalaya or google
HIMALAYA_ACCOUNTgru_gmailhimalaya account name
OPENAI_API_KEYOptional AI classification

Cron

# Daily at 7 AM
0 7 * * * cd /path/to/inbox-triage-bot && EMAIL_BACKEND=himalaya npm run demo >> ~/inbox-triage.md 2>&1

Links