Skip to content
Development
Skill

/gws-gmail-read

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

BOOST
@googleworkspacegoogleworkspace@googleworkspace
From plugin
cli
32k95 skills

Claude Code

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

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 ↗
Stats
JavaScriptNodeHTMLBashRustGCPLinuxGitGitHubGemini
32,318
Stars
1,996
Forks
Active
Maintenance
Rust
Language
Apache-2.0
License
Last commit
Created

Repo: googleworkspace/cli

In this plugin
95 skills
See everything inside
@googleworkspace
Ships withcli

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.

32k95 skills
Get the whole plugin

Stars on GitHub

Momentum

stars in total
32.1k
Star history of googleworkspace/cli on GitHub, a chart by star-history.com
See what's trending this week

Other skills on cli.

See all 95 skills in cli

More skills from other plugins.

brainstorming
Auto-invoked

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…

superpowers2w311k
@obra@obraInstall Skill
ask-matt

ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

skills2w309k
@mattpocock@mattpocockInstall Skill
accessibility
Auto-invoked

accessibility

Design, implement, and audit accessible UI to WCAG 2.2 Level AA across Web, iOS, and Android — semantic ARIA roles and labels,…

ecc2w293k
@affaan-m@affaan-mInstall Skill
compiler-commit

compiler-commit

Use when you want to verify compiler changes and commit with the correct convention. Runs tests, lint, and format, then commits…

react5d252k
@facebook@facebookInstall Skill

Questions about gws-gmail-read.

Which coding agents can use gws-gmail-read?
gws-gmail-read installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.