Skip to content
Development
Skill

/gws-gmail-read

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

Boost this skill
@googleworkspacegoogleworkspace@googleworkspace
From plugin
googleworkspace-cli
31k95 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.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • 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.

See Also

  • [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
  • [gws-gmail](../gws-gmail/SKILL.md) — All send, read, and manage email commands
Read it on GitHub ↗
Ships withgoogleworkspace-cli

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.

Get the whole plugin
Stats
JavaScriptNodeHTMLBashRust
+5 tags
GCPLinuxGitGitHubGemini
31,012
Stars
1,833
Forks
Active
Maintenance
Rust
Language
Apache-2.0
License
1d ago
Last commit
6mo ago
Created

Repo: googleworkspace/cli

In this plugin
95 skills
See everything inside

Other skills on googleworkspace-cli.

See all 95 skills in googleworkspace-cli