{"id":"fd1c5584-afdd-42ae-93ea-ab0c2373c8d7","shortId":"cAhjrp","kind":"skill","title":"gws-gmail-read","tagline":"Gmail: Read a message and extract its body or headers.","description":"# gmail +read\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\nRead a message and extract its body or headers\n\n## Usage\n\n```bash\ngws gmail +read --id <ID>\n```\n\n## Flags\n\n| Flag | Required | Default | Description |\n|------|----------|---------|-------------|\n| `--id` | ✓ | — | The Gmail message ID to read |\n| `--headers` | — | — | Include headers (From, To, Subject, Date) in the output |\n| `--format` | — | text | Output format (text, json) |\n| `--html` | — | — | Return HTML body instead of plain text |\n| `--dry-run` | — | — | Show the request that would be sent without executing it |\n\n## Examples\n\n```bash\ngws gmail +read --id 18f1a2b3c4d\ngws gmail +read --id 18f1a2b3c4d --headers\ngws gmail +read --id 18f1a2b3c4d --format json | jq '.body'\n```\n\n## Tips\n\n- Converts HTML-only messages to plain text automatically.\n- Handles multipart/alternative and base64 decoding.\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","read","cli","googleworkspace","agent-skills","ai-agent","automation","discovery-api","gemini-cli-extension","google-admin","google-api"],"capabilities":["skill","source-googleworkspace","skill-gws-gmail-read","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-read","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,130 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.065Z","embedding":null,"createdAt":"2026-04-18T20:26:18.019Z","updatedAt":"2026-05-18T18:52:30.065Z","lastSeenAt":"2026-05-18T18:52:30.065Z","tsv":"'/gws-gmail/skill.md':151 '/gws-shared/skill.md':19,143 '18f1a2b3c4d':107,112,118 'also':139 'auth':21,147 'automat':132 'base64':136 'bash':47,102 'bodi':12,43,83,122 'command':158 'convert':124 'creat':35 'date':70 'decod':137 'default':55 'descript':56 'dri':89 'dry-run':88 'email':157 'exampl':101 'execut':99 'extract':10,41 'flag':23,52,53,145 'format':74,77,119 'generat':32 'generate-skil':31 'global':22,144 'gmail':3,5,15,49,59,104,109,115,150 'gws':2,30,48,103,108,114,141,149 'gws-gmail':148 'gws-gmail-read':1 'gws-share':140 'handl':133 'header':14,45,64,66,113 'html':80,82,126 'html-on':125 'id':51,57,61,106,111,117 'includ':65 'instead':84 'jq':121 'json':79,120 'manag':156 'messag':8,39,60,128 'miss':28 'multipart/alternative':134 'output':73,76 'plain':86,130 'prerequisit':17 'read':4,6,16,18,37,50,63,105,110,116,154 'request':93 'requir':54 'return':81 'rule':26 'run':29,90 'secur':25 'see':138 'send':153 'sent':97 'share':142 'show':91 'skill':33 'skill-gws-gmail-read' 'source-googleworkspace' 'subject':69 'text':75,78,87,131 'tip':123 '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' 'usag':46 'without':98 'would':95","prices":[{"id":"db565d9c-15c6-4efd-b9aa-66a4de292489","listingId":"fd1c5584-afdd-42ae-93ea-ab0c2373c8d7","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:26:18.019Z"}],"sources":[{"listingId":"fd1c5584-afdd-42ae-93ea-ab0c2373c8d7","source":"github","sourceId":"googleworkspace/cli/gws-gmail-read","sourceUrl":"https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail-read","isPrimary":false,"firstSeenAt":"2026-04-18T21:51:54.802Z","lastSeenAt":"2026-05-18T18:52:30.065Z"},{"listingId":"fd1c5584-afdd-42ae-93ea-ab0c2373c8d7","source":"skills_sh","sourceId":"googleworkspace/cli/gws-gmail-read","sourceUrl":"https://skills.sh/googleworkspace/cli/gws-gmail-read","isPrimary":true,"firstSeenAt":"2026-04-18T20:26:18.019Z","lastSeenAt":"2026-05-07T22:40:16.187Z"}],"details":{"listingId":"fd1c5584-afdd-42ae-93ea-ab0c2373c8d7","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"googleworkspace","slug":"gws-gmail-read","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":"dc153af4477a416e235eb1377c53eae4e11c1bb9","skill_md_path":"skills/gws-gmail-read/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail-read"},"layout":"multi","source":"github","category":"cli","frontmatter":{"name":"gws-gmail-read","description":"Gmail: Read a message and extract its body or headers."},"skills_sh_url":"https://skills.sh/googleworkspace/cli/gws-gmail-read"},"updatedAt":"2026-05-18T18:52:30.065Z"}}