googleworkspace/cli

gws-gmail-read

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

41K installs 32K stars

Before you install

Last update
Files in folder
1
Scripts
No script files found
SKILL.md size
1.4 KB (about 350 tokens of context each time it loads)
License
Apache-2.0
Source on GitHub
googleworkspace/cli

Skills are plain text instructions the agent follows, sometimes with scripts. Check the source, prefer repositories with many installs and stars, and read any script it ships.

Install

npx skills add googleworkspace/cli@gws-gmail-read

Runs in a terminal with Node.js 18 or newer. Add -y to skip the prompts and -g to install for every project instead of this one.

Install for your agent

npx skills add googleworkspace/cli@gws-gmail-read --agent claude-code -y
Project install writes to
.claude/skills/gws-gmail-read
Global install writes to
~/.claude/skills/gws-gmail-read

Start a new session afterwards so the agent picks the skill up. In Claude Code you can also call it directly with /gws-gmail-read.

What it does

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 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 Tips - Converts HTML-only messages to…

Excerpt from the skill's own SKILL.md. Read the full file on GitHub before installing: skills run with your agent's permissions.

Categories

Related skills

  • gws-gmail

    googleworkspace/cli

    Gmail: Send, read, and manage email.

    81K installs 32KSecurity
  • gws-gmail-send

    googleworkspace/cli

    Gmail: Send an email.

    74K installs 32KSecurity
  • gws-drive

    googleworkspace/cli

    Google Drive: Manage files, folders, and shared drives.

    74K installs 32KSecurity
  • gws-shared

    googleworkspace/cli

    gws CLI: Shared patterns for authentication, global flags, and output formatting.

    65K installs 32KDocumentationDataWriting
  • gws-calendar

    googleworkspace/cli

    Google Calendar: Manage calendars and events.

    60K installs 32KSecurity
  • gws-sheets

    googleworkspace/cli

    Google Sheets: Read and write spreadsheets.

    58K installs 32KSecurityData

← Search skills

/skills/googleworkspace/cli/gws-gmail-read/