# Vip Email

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

- **Type:** Skill
- **Install:** `agentstack add skill-argentaios-agent-skills-vip-email`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ArgentAIOS](https://agentstack.voostack.com/s/argentaios)
- **Installs:** 0
- **Category:** [Communication](https://agentstack.voostack.com/c/communication)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ArgentAIOS](https://github.com/ArgentAIOS)
- **Source:** https://github.com/ArgentAIOS/agent-skills/tree/main/vip-email

## Install

```sh
agentstack add skill-argentaios-agent-skills-vip-email
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ArgentAIOS](https://github.com/ArgentAIOS)
- **Source:** [ArgentAIOS/agent-skills](https://github.com/ArgentAIOS/agent-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-argentaios-agent-skills-vip-email
- Seller: https://agentstack.voostack.com/s/argentaios
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.