# Vip Email

> Configure and operate VIP Gmail monitoring with deduped alerts, cron scanning, and gog OAuth fallback.

- Skill: `argentaios/vip-email` (Agent Skill)
- Install (CLI): `npx skillmds@latest add argentaios/vip-email`
- Raw SKILL.md: https://api.skillmd.com/api/skills/argentaios/vip-email/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: argentaios (https://skillmd.com/u/argentaios)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/argentaios/vip-email

---


# vip-email

Use the `vip_email` tool to monitor high-priority senders in Gmail and alert once per new message.

## First run (required)

If `vip_email` reports `setupRequired: true`, switch to the `gog` skill and complete OAuth:

- `gog auth credentials /path/to/client_secret.json`
- `gog auth add you@gmail.com --services gmail,calendar,drive,contacts,docs,sheets`
- `gog auth list --json`

Then return to `vip_email`.

## Core setup

1. Add VIP senders:
   - `vip_email` action `add_vip` with `email` and optional `name`
2. Set allowed inbox accounts (optional; defaults to discovered gog accounts):
   - `vip_email` action `set_accounts` with `accounts`
3. Configure alerts:
   - `vip_email` action `set_alerts` with:
     - `ttsEnabled` (true/false)
     - `channelRoutes` array (`channel`, `target`, optional `accountId`, `bestEffort`)
4. Install monitor cron:
   - `vip_email` action `ensure_cron_monitor` with optional `intervalSeconds`

## Operations

- Health/status: `vip_email` action `status`
- Manual scan now: `vip_email` action `scan_now`
- List VIPs: `vip_email` action `list_vips`
- Remove VIP: `vip_email` action `remove_vip`
- Read and clear queued items: `vip_email` action `check_pending` (`clear` defaults true)
- Disable monitor cron: `vip_email` action `disable_cron_monitor`
- Reset dedupe set: `vip_email` action `clear_seen`

## Notes

- Dedupe is key-based per account+message id; the same email should not alert twice.
- Pending queue defaults to `/tmp/vip-email-pending.json` for downstream processors.
- Cron monitor runs isolated and invokes `vip_email` scan action.