# Gruted Inbox Triage

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

- Skill: `lord1egypt/gruted-inbox-triage` (Agent Skill)
- Install (CLI): `npx skillmds@latest add lord1egypt/gruted-inbox-triage`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lord1egypt/gruted-inbox-triage/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: Lord1Egypt (https://skillmd.com/u/lord1egypt)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/lord1egypt/gruted-inbox-triage

---


# inbox-triage-bot

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

## Quick start

```bash
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:

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

### Google API (alternative)

Requires OAuth credentials:

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

## Commands

```bash
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

| Variable | Default | Description |
|----------|---------|-------------|
| `EMAIL_BACKEND` | auto | `himalaya` or `google` |
| `HIMALAYA_ACCOUNT` | `gru_gmail` | himalaya account name |
| `OPENAI_API_KEY` | — | Optional AI classification |

## Cron

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

## Links

- GitHub: https://github.com/gruted/inbox-triage-bot
- Landing page: https://gruted.github.io/inbox-triage-bot/