{"id":"4b50f05b-8fd2-420f-a97c-8db14913dd3c","shortId":"hkZnJe","kind":"skill","title":"Gws Gmail Watch","tagline":"Cli skill by Googleworkspace","description":"# gmail +watch\n\n> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.\n\nWatch for new emails and stream them as NDJSON\n\n## Usage\n\n```bash\ngws gmail +watch\n```\n\n## Flags\n\n| Flag | Required | Default | Description |\n|------|----------|---------|-------------|\n| `--project` | — | — | GCP project ID for Pub/Sub resources |\n| `--subscription` | — | — | Existing Pub/Sub subscription name (skip setup) |\n| `--topic` | — | — | Existing Pub/Sub topic with Gmail push permission already granted |\n| `--label-ids` | — | — | Comma-separated Gmail label IDs to filter (e.g., INBOX,UNREAD) |\n| `--max-messages` | — | 10 | Max messages per pull batch |\n| `--poll-interval` | — | 5 | Seconds between pulls |\n| `--msg-format` | — | full | Gmail message format: full, metadata, minimal, raw |\n| `--once` | — | — | Pull once and exit |\n| `--cleanup` | — | — | Delete created Pub/Sub resources on exit |\n| `--output-dir` | — | — | Write each message to a separate JSON file in this directory |\n\n## Examples\n\n```bash\ngws gmail +watch --project my-gcp-project\ngws gmail +watch --project my-project --label-ids INBOX --once\ngws gmail +watch --subscription projects/p/subscriptions/my-sub\ngws gmail +watch --project my-project --cleanup --output-dir ./emails\n```\n\n## Tips\n\n- Gmail watch expires after 7 days — re-run to renew.\n- Without --cleanup, Pub/Sub resources persist for reconnection.\n- Press Ctrl-C to stop gracefully.\n\n## See Also\n\n- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth\n- [gws-gmail](../gws-gmail/SKILL.md) — All send, read, and manage email commands","tags":["gws","gmail","watch","cli","googleworkspace"],"capabilities":["skill","source-googleworkspace","category-cli"],"categories":["cli"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/googleworkspace/cli/gws-gmail-watch","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"install_from":"skills.sh"}},"qualityScore":"0.300","qualityRationale":"deterministic score 0.30 from registry signals: · indexed on skills.sh · published under googleworkspace/cli","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill:v1","enrichmentVersion":1,"enrichedAt":"2026-04-22T08:40:09.319Z","embedding":null,"createdAt":"2026-04-18T20:24:37.966Z","updatedAt":"2026-04-22T08:40:09.319Z","lastSeenAt":"2026-04-22T08:40:09.319Z","tsv":"'/emails':178 '/gws-gmail/skill.md':218 '/gws-shared/skill.md':12,210 '10':90 '5':99 '7':184 'alreadi':71 'also':206 'auth':14,214 'bash':40,141 'batch':95 'c':201 'category-cli' 'cleanup':119,174,192 'cli':4 'comma':77 'comma-separ':76 'command':225 'creat':28,121 'ctrl':200 'ctrl-c':199 'day':185 'default':47 'delet':120 'descript':48 'dir':128,177 'directori':139 'e.g':84 'email':33,224 'exampl':140 'exist':57,64 'exit':118,125 'expir':182 'file':136 'filter':83 'flag':16,44,45,212 'format':105,109 'full':106,110 'gcp':50,148 'generat':25 'generate-skil':24 'global':15,211 'gmail':2,8,42,68,79,107,143,151,163,168,180,217 'googleworkspac':7 'grace':204 'grant':72 'gws':1,23,41,142,150,162,167,208,216 'gws-gmail':215 'gws-share':207 'id':52,75,81,159 'inbox':85,160 'interv':98 'json':135 'label':74,80,158 'label-id':73,157 'manag':223 'max':88,91 'max-messag':87 'messag':89,92,108,131 'metadata':111 'minim':112 'miss':21 'msg':104 'msg-format':103 'my-gcp-project':146 'my-project':154,171 'name':60 'ndjson':38 'new':32 'output':127,176 'output-dir':126,175 'per':93 'permiss':70 'persist':195 'poll':97 'poll-interv':96 'prerequisit':10 'press':198 'project':49,51,145,149,153,156,170,173 'projects/p/subscriptions/my-sub':166 'pub/sub':54,58,65,122,193 'pull':94,102,115 'push':69 'raw':113 're':187 're-run':186 'read':11,221 'reconnect':197 'renew':190 'requir':46 'resourc':55,123,194 'rule':19 'run':22,188 'second':100 'secur':18 'see':205 'send':220 'separ':78,134 'setup':62 'share':209 'skill':5,26 'skip':61 'source-googleworkspace' 'stop':203 'stream':35 'subscript':56,59,165 'tip':179 'topic':63,66 'unread':86 'usag':39 'watch':3,9,30,43,144,152,164,169,181 'without':191 'write':129","prices":[{"id":"4f6d66fb-608a-43fc-bb70-e857de257e46","listingId":"4b50f05b-8fd2-420f-a97c-8db14913dd3c","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"googleworkspace","category":"cli","install_from":"skills.sh"},"createdAt":"2026-04-18T20:24:37.966Z"}],"sources":[{"listingId":"4b50f05b-8fd2-420f-a97c-8db14913dd3c","source":"github","sourceId":"googleworkspace/cli/gws-gmail-watch","sourceUrl":"https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail-watch","isPrimary":false,"firstSeenAt":"2026-04-18T21:51:58.077Z","lastSeenAt":"2026-04-22T06:52:36.232Z"},{"listingId":"4b50f05b-8fd2-420f-a97c-8db14913dd3c","source":"skills_sh","sourceId":"googleworkspace/cli/gws-gmail-watch","sourceUrl":"https://skills.sh/googleworkspace/cli/gws-gmail-watch","isPrimary":true,"firstSeenAt":"2026-04-18T20:24:37.966Z","lastSeenAt":"2026-04-22T08:40:09.319Z"}],"details":{"listingId":"4b50f05b-8fd2-420f-a97c-8db14913dd3c","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"googleworkspace","slug":"gws-gmail-watch","source":"skills_sh","category":"cli","skills_sh_url":"https://skills.sh/googleworkspace/cli/gws-gmail-watch"},"updatedAt":"2026-04-22T08:40:09.319Z"}}