Back to skills
SKILL.md
Gws Gmail Read
ASecurityGmail: Read a message and extract its body or headers.
- 9 stars
- 0 votes
- 0 copies
- 0 views
- Added September 3, 2026
Security analysis
100/100npx -y skills add raffaelefarinaro/ciaobot --skill gws-gmail-read --agent claude-codeAre you the author of Gws Gmail Read?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/raffaelefarinaro-gws-gmail-read)---
name: gws-gmail-read
description: "Gmail: Read a message and extract its body or headers."
metadata:
version: 0.22.5
---
# gmail +read
> **PREREQUISITE:** Read `gws-shared` for Ciaobot auth (via `ciao gws`), global flags, and security rules.
Read a message and extract its body or headers
## Usage
```bash
ciao gws "$GWS_PROFILE" gmail +read --id <ID>
```
## Flags
| Flag | Required | Default | Description |
|------|----------|---------|-------------|
| `--id` | ✓ | — | The Gmail message ID to read |
| `--headers` | — | — | Include headers (From, To, Subject, Date) in the output |
| `--format` | — | text | Output format (text, json) |
| `--html` | — | — | Return HTML body instead of plain text |
| `--dry-run` | — | — | Show the request that would be sent without executing it |
## Examples
```bash
ciao gws "$GWS_PROFILE" gmail +read --id 18f1a2b3c4d
ciao gws "$GWS_PROFILE" gmail +read --id 18f1a2b3c4d --headers
ciao gws "$GWS_PROFILE" gmail +read --id 18f1a2b3c4d --format json | jq '.body'
```
## Tips
- Converts HTML-only messages to plain text automatically.
- Handles multipart/alternative and base64 decoding.
Attribution
Comments
Loading comments…