email-reader
Read/search Gmail via gog CLI. Inbox check, email search, content retrieval.
Informações da origem
- Repositório
- modbender/skill-library-mcp
- Última atividade na origem
- 30 de março de 2026 às 17:14
- Idioma detectado do SKILL.md
- inglês
- Estrelas
- 12
- Forks
- 3
Opções de instalação
Por padrão, está selecionado o prompt que primeiro revisa a origem. Você pode mudar para um comando direto ou baixar uma cópia local.
Revise os arquivos de origem
Leia o SKILL.md e os arquivos complementares exibidos pelo SkillsMP antes de decidir se vai instalar.
Exibindo SKILL.md
SKILL.md
Instruções da origem · Visualização somente leitura- 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`
Ver no GitHub