SKILL.md
Gmail
<!-- Generated by scripts/gen-agent-skills.mjs; do not edit. -->
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 [email protected] 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 | ||
import |
Import an RFC822/EML message into Gmail | ||
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.