email-reader
Read/search Gmail via gog CLI. Inbox check, email search, content retrieval.
Informations de source
- Dépôt
- modbender/skill-library-mcp
- Dernière activité de la source
- 30 mars 2026 à 17:14
- Langue détectée de SKILL.md
- anglais
- Étoiles
- 12
- Forks
- 3
Options d'installation
Le prompt qui vérifie d'abord la source est sélectionné par défaut. Vous pouvez passer à une commande directe ou télécharger une copie locale.
Vérifiez les fichiers source
Lisez SKILL.md et les fichiers associés affichés par SkillsMP avant de décider de l'installer.
Affichage de SKILL.md
SKILL.md
Instructions source · Aperçu en lecture seule- name
- email-reader
- description
- Read/search Gmail via gog CLI. Inbox check, email search, content retrieval.
- user-invocable
- true
- tools
- Bash
- metadata
- {"openclaw":{"emoji":"📬","requires":{"bins":"[Truncated]","env":"[Truncated]"}}}
# email-reader
## When to use
User asks to check inbox, search emails, read email content, or summarize recent messages.
## Commands
```bash
# List unread (default action)
gog gmail search 'in:inbox is:unread' --max 5 --format minimal --json
# Search by criteria (use Gmail search syntax)
gog gmail search '<query>' --max 10 --format minimal --json
# Read full email
gog gmail get <message_id> --format full --json
# Get thread
gog gmail thread <thread_id> --format minimal --json
```
## Workflow
1. Verify `gog` on PATH and `GOG_ACCOUNT` set
2. Build Gmail search query from user intent — ask if ambiguous
3. Run `gog gmail search` with `--format minimal --json --max N`
4. Parse JSON → present formatted list (sender, subject, date, snippet, ID)
5. Offer: read full email, refine search, or act on message
## Output format
```
📬 [count] emails:
1. **From:** Name <email> | **Subject:** … | **Date:** YYYY-MM-DD HH:MM
Preview: … | ID: msg_xxx
```
## Rules
- ALWAYS use `--format minimal --json --max N` (default N=5)
- Never show raw JSON; never fetch full content unless asked
- Preserve message IDs for follow-up actions
- Empty results → confirm criteria, suggest broader terms
- Read-only; send/reply requires email-responder skill
- Never store email content in MEMORY.md unless user requests
## Error handling
- `gog` missing → show install: `npm i -g gogcli` or `brew install gogcli`
- `GOG_ACCOUNT` unset → ask user for Gmail address
- Token expired → `gog auth add <email>`
- API error → show error, suggest fix
## Gmail search operators
`from:` `to:` `subject:` `label:` `is:unread` `is:starred` `has:attachment` `newer_than:Nd` `older_than:Nd` `in:inbox` `in:sent` `filename:ext`
Voir sur GitHub