gog-gmail

Gmail operations through gog.

Quality

72%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/gog-gmail/SKILL.md

Gmail

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-untrusted for agent-readable Google content.
Use --readonly when the task must not mutate Google data.
Use --no-input in automation and --dry-run before 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.

Repository: openclaw/gogcli
Path: .agents/skills/gog-gmail/SKILL.md
Commit: 1dbd820

Last updated: about 23 hours ago
First committed: about 1 month ago

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.