gmaillisted

# Gmail Skill Search, read, send, and manage Gmail messages, drafts, labels, and filters using the `gws` CLI. --- ## Auth Approach Do NOT check authentication upfront. Just run the command. If it fails with an auth error (exit code 2), see the **Self-Healing** section for diagnostics. --- ## Tool Preference All operations use the `gws` CLI directly. No wrapper scripts. - **Helper commands** (prefixed with `+`): Use for common operations. These handle formatting, threading, and MIME encoding automatically. - **Raw API calls**: Use when no helper exists. Pass parameters via `--params '<JSON>'` and request bodies via `--json '<JSON>'`. Resource paths are space-separated (e.g., `gws gmail users messages list`). Always prefer `+` helpers when one exists for the operation. --- ## Operations — Tier 1 (Read) ### Triage Inbox Show unread inbox summary: ```bash gws gmail +triage ``` Filtered/customized: ```bash gws gmail +triage --query 'from:boss' --max 5 gws gmail +triage --labels gws gmail +triage --format table ``` ### Read a Message ```bash gws gmail +read --id <messageId> gws gmail +read --id <messageId> --headers gws gmail +read --id <messageId> --format json ``` ### Search / List Messages ```bash gws gmail users messages list --params '{"userId": "me", "q": "<query>"}' ``` See `gmail-search-recipes.md` for query syntax. ### List Labels ```bash gws gmail users labels list --params '{"userId": "me"}' ``` --- ## Operations — Tier 2 (Write) ### Send Email `