Agent-Skills.md

Agent Skills: gmail +read

Gmail: Read a message and extract its body or headers.

productivityID: mattforni/dotfiles/gws-gmail-read

Repository

mattforni/dotfiles
mattforni
21

Install this agent skill to your local

pnpm dlx add-skill https://github.com/mattforni/homebase/tree/HEAD/.claude/skills/gws-gmail-read

Skill Files

Browse the full folder contents for gws-gmail-read.

Download Skill

Loading file tree…

.claude/skills/gws-gmail-read/SKILL.md

Skill Metadata

Name
gws-gmail-read
Description
"Gmail: Read a message and extract its body or headers."

gmail +read

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

Read a message and extract its body or headers

Usage

gws 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

gws gmail +read --id 18f1a2b3c4d
gws gmail +read --id 18f1a2b3c4d --headers
gws gmail +read --id 18f1a2b3c4d --format json | jq '.body'

Tips

  • Converts HTML-only messages to plain text automatically.
  • Handles multipart/alternative and base64 decoding.

See Also