{"id":"c70c2f9b-d064-4024-976c-ef7cc30cff4f","shortId":"4qdZqL","kind":"skill","title":"gws-gmail","tagline":"Gmail: Send, read, and manage email.","description":"# gmail (v1)\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\n```bash\ngws gmail <resource> <method> [flags]\n```\n\n## Helper Commands\n\n| Command | Description |\n|---------|-------------|\n| [`+send`](../gws-gmail-send/SKILL.md) | Send an email |\n| [`+triage`](../gws-gmail-triage/SKILL.md) | Show unread inbox summary (sender, subject, date) |\n| [`+reply`](../gws-gmail-reply/SKILL.md) | Reply to a message (handles threading automatically) |\n| [`+reply-all`](../gws-gmail-reply-all/SKILL.md) | Reply-all to a message (handles threading automatically) |\n| [`+forward`](../gws-gmail-forward/SKILL.md) | Forward a message to new recipients |\n| [`+read`](../gws-gmail-read/SKILL.md) | Read a message and extract its body or headers |\n| [`+watch`](../gws-gmail-watch/SKILL.md) | Watch for new emails and stream them as NDJSON |\n\n## API Resources\n\n### users\n\n  - `getProfile` — Gets the current user's Gmail profile.\n  - `stop` — Stop receiving push notifications for the given user mailbox.\n  - `watch` — Set up or update a push notification watch on the given user mailbox.\n  - `drafts` — Operations on the 'drafts' resource\n  - `history` — Operations on the 'history' resource\n  - `labels` — Operations on the 'labels' resource\n  - `messages` — Operations on the 'messages' resource\n  - `settings` — Operations on the 'settings' resource\n  - `threads` — Operations on the 'threads' resource\n\n## Discovering Commands\n\nBefore calling any API method, inspect it:\n\n```bash\n# Browse resources and methods\ngws gmail --help\n\n# Inspect a method's required params, types, and defaults\ngws schema gmail.<resource>.<method>\n```\n\nUse `gws schema` output to build your `--params` and `--json` flags.","tags":["gws","gmail","cli","googleworkspace","agent-skills","ai-agent","automation","discovery-api","gemini-cli-extension","google-admin","google-api","google-calendar"],"capabilities":["skill","source-googleworkspace","skill-gws-gmail","topic-agent-skills","topic-ai-agent","topic-automation","topic-cli","topic-discovery-api","topic-gemini-cli-extension","topic-google-admin","topic-google-api","topic-google-calendar","topic-google-chat","topic-google-docs","topic-google-drive"],"categories":["cli"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/googleworkspace/cli/gws-gmail","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add googleworkspace/cli","source_repo":"https://github.com/googleworkspace/cli","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 26371 github stars · SKILL.md body (1,780 chars)","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-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T18:52:30.453Z","embedding":null,"createdAt":"2026-04-18T20:24:16.232Z","updatedAt":"2026-05-18T18:52:30.453Z","lastSeenAt":"2026-05-18T18:52:30.453Z","tsv":"'/gws-gmail-forward/skill.md':77 '/gws-gmail-read/skill.md':85 '/gws-gmail-reply-all/skill.md':66 '/gws-gmail-reply/skill.md':55 '/gws-gmail-send/skill.md':41 '/gws-gmail-triage/skill.md':46 '/gws-gmail-watch/skill.md':96 '/gws-shared/skill.md':14 'api':106,182 'auth':16 'automat':62,75 'bash':32,186 'bodi':92 'brows':187 'build':211 'call':180 'command':37,38,178 'creat':30 'current':112 'date':53 'default':202 'descript':39 'discov':177 'draft':141,145 'email':9,44,100 'extract':90 'flag':18,35,216 'forward':76,78 'generat':27 'generate-skil':26 'get':110 'getprofil':109 'given':124,138 'global':17 'gmail':3,4,10,34,115,192,205 'gws':2,25,33,191,203,207 'gws-gmail':1 'handl':60,73 'header':94 'help':193 'helper':36 'histori':147,151 'inbox':49 'inspect':184,194 'json':215 'label':153,157 'mailbox':126,140 'manag':8 'messag':59,72,80,88,159,163 'method':183,190,196 'miss':23 'ndjson':105 'new':82,99 'notif':121,134 'oper':142,148,154,160,166,172 'output':209 'param':199,213 'prerequisit':12 'profil':116 'push':120,133 'read':6,13,84,86 'receiv':119 'recipi':83 'repli':54,56,64,68 'reply-al':63,67 'requir':198 'resourc':107,146,152,158,164,170,176,188 'rule':21 'run':24 'schema':204,208 'secur':20 'send':5,40,42 'sender':51 'set':128,165,169 'show':47 'skill':28 'skill-gws-gmail' 'source-googleworkspace' 'stop':117,118 'stream':102 'subject':52 'summari':50 'thread':61,74,171,175 'topic-agent-skills' 'topic-ai-agent' 'topic-automation' 'topic-cli' 'topic-discovery-api' 'topic-gemini-cli-extension' 'topic-google-admin' 'topic-google-api' 'topic-google-calendar' 'topic-google-chat' 'topic-google-docs' 'topic-google-drive' 'triag':45 'type':200 'unread':48 'updat':131 'use':206 'user':108,113,125,139 'v1':11 'watch':95,97,127,135","prices":[{"id":"68a85494-20d2-4efa-8d32-54a46e1eab5c","listingId":"c70c2f9b-d064-4024-976c-ef7cc30cff4f","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:16.232Z"}],"sources":[{"listingId":"c70c2f9b-d064-4024-976c-ef7cc30cff4f","source":"github","sourceId":"googleworkspace/cli/gws-gmail","sourceUrl":"https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail","isPrimary":false,"firstSeenAt":"2026-04-18T21:51:58.762Z","lastSeenAt":"2026-05-18T18:52:30.453Z"},{"listingId":"c70c2f9b-d064-4024-976c-ef7cc30cff4f","source":"skills_sh","sourceId":"googleworkspace/cli/gws-gmail","sourceUrl":"https://skills.sh/googleworkspace/cli/gws-gmail","isPrimary":true,"firstSeenAt":"2026-04-18T20:24:16.232Z","lastSeenAt":"2026-05-07T22:40:14.233Z"}],"details":{"listingId":"c70c2f9b-d064-4024-976c-ef7cc30cff4f","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"googleworkspace","slug":"gws-gmail","github":{"repo":"googleworkspace/cli","stars":26371,"topics":["agent-skills","ai-agent","automation","cli","discovery-api","gemini-cli-extension","google-admin","google-api","google-calendar","google-chat","google-docs","google-drive","google-sheets","google-workspace","oauth2","rust"],"license":"apache-2.0","html_url":"https://github.com/googleworkspace/cli","pushed_at":"2026-05-12T16:46:11Z","description":"Google Workspace CLI — one command-line tool for Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, and more. Dynamically built from Google Discovery Service. Includes AI agent skills.","skill_md_sha":"3423770e6e31c13e1f1ec2ecfa81dc911e9428ae","skill_md_path":"skills/gws-gmail/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail"},"layout":"multi","source":"github","category":"cli","frontmatter":{"name":"gws-gmail","description":"Gmail: Send, read, and manage email."},"skills_sh_url":"https://skills.sh/googleworkspace/cli/gws-gmail"},"updatedAt":"2026-05-18T18:52:30.453Z"}}