/gws-gmail-read

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

googleworkspace@googleworkspace

GitHub

From plugin

cli

30k95 skills

Install

$ npx -y skills add googleworkspace/cli --skill gws-gmail-read --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.
You can call itInvoke it directly when you want it.
Slash command/gws-gmail-read

Context preview

The summary Claude sees to decide when to auto-load this skill.

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

SKILL.md

gws-gmail-read.SKILL.md

name: gws-gmail-read
description: "Gmail: Read a message and extract its body or headers."
metadata:
  version: 0.22.5
  openclaw:
    category: "productivity"
    requires:
      bins:
        - gws
    cliHelp: "gws gmail +read --help"

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.

Other skills on cli.

See all 95 skills in cli