Gmail
Add-on: gog, from gogcli. The person installs it from the tool guide page tools/cli/gogcli.md.
Mac-only: no.
Use gog for Gmail operations. Read ../gog/SKILL.md first for shared auth,
output, safety, and live-write rules.
Safe start
gog auth list --check --json --no-input
gog schema gmail --json
gog --readonly --account user@example.com gmail search 'newer_than:7d' --max 10 --json --wrap-untrusted
- Select the account explicitly with
--account. - Use
--json --wrap-untrustedfor agent-readable Google content. - Use
--readonlywhen the task must not mutate Google data. - Use
--no-inputin automation and--dry-runbefore supported writes. - Confirm the exact account, object, and mutation before any write or delete.
Commands
| Command | Purpose |
|---|---|
archive | Archive messages or explicit threads (remove from inbox) |
attachment | Download a single attachment |
autoreply | Reply once to matching messages |
batch | Batch operations (permanent delete requires broader Gmail scope; use gmail trash for normal trashing) |
drafts | Draft operations |
forward | Forward a message to new recipients |
get | Get a message (full|metadata|raw) |
history | Gmail history |
labels | Label operations |
mark-read | Mark messages as read |
messages | Message operations |
raw | Dump raw Gmail API response as JSON (Users.Messages.Get; lossless; for scripting and LLM consumption) |
reply | Reply to a message |
reply-all | Reply to all message participants |
search | Search threads using Gmail query syntax |
send | Send an email |
settings | Settings and admin |
thread | Thread operations (get, modify) |
track | Email open tracking |
trash | Move messages to trash |
unread | Mark messages as unread |
url | Print Gmail web URLs for threads |
Run gog gmail <command> --help for flags and gog schema gmail <command> --json
for the machine-readable contract. Do not guess command syntax.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |