email-reader
Read/search Gmail via gog CLI. Inbox check, email search, content retrieval.
Source facts
- Repository
- modbender/skill-library-mcp
- Last source activity
- March 30, 2026 at 17:14
- Detected SKILL.md language
- English
- Stars
- 12
- Forks
- 3
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Showing SKILL.md
SKILL.md
Source instructions · Read-only preview- 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`
View on GitHub