{"id":"fd1c5584-afdd-42ae-93ea-ab0c2373c8d7","shortId":"cAhjrp","kind":"skill","title":"Gws Gmail Read","tagline":"Cli skill by Googleworkspace","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"],"capabilities":["skill","source-googleworkspace","category-cli"],"categories":["cli"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/googleworkspace/cli/gws-gmail-read","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-22T03:40:14.154Z","embedding":null,"createdAt":"2026-04-18T20:26:18.019Z","updatedAt":"2026-04-22T03:40:14.154Z","lastSeenAt":"2026-04-22T03:40:14.154Z","tsv":"'/gws-gmail/skill.md':144 '/gws-shared/skill.md':12,136 '18f1a2b3c4d':100,105,111 'also':132 'auth':14,140 'automat':125 'base64':129 'bash':40,95 'bodi':36,76,115 'category-cli' 'cli':4 'command':151 'convert':117 'creat':28 'date':63 'decod':130 'default':48 'descript':49 'dri':82 'dry-run':81 'email':150 'exampl':94 'execut':92 'extract':34 'flag':16,45,46,138 'format':67,70,112 'generat':25 'generate-skil':24 'global':15,137 'gmail':2,8,42,52,97,102,108,143 'googleworkspac':7 'gws':1,23,41,96,101,107,134,142 'gws-gmail':141 'gws-share':133 'handl':126 'header':38,57,59,106 'html':73,75,119 'html-on':118 'id':44,50,54,99,104,110 'includ':58 'instead':77 'jq':114 'json':72,113 'manag':149 'messag':32,53,121 'miss':21 'multipart/alternative':127 'output':66,69 'plain':79,123 'prerequisit':10 'read':3,9,11,30,43,56,98,103,109,147 'request':86 'requir':47 'return':74 'rule':19 'run':22,83 'secur':18 'see':131 'send':146 'sent':90 'share':135 'show':84 'skill':5,26 'source-googleworkspace' 'subject':62 'text':68,71,80,124 'tip':116 'usag':39 'without':91 'would':88","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-04-22T00:52:21.030Z"},{"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-04-22T03:40:14.154Z"}],"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","source":"skills_sh","category":"cli","skills_sh_url":"https://skills.sh/googleworkspace/cli/gws-gmail-read"},"updatedAt":"2026-04-22T03:40:14.154Z"}}