SkillsAdd

googleworkspace/cli · Official

gws-gmail-read

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

All-time #633 Trending #1336 Hot #3598 First seen Mar 17, 2026
8-week activity · all time api

Installation

$ npx skills add googleworkspace/cli --skill gws-gmail-read
View on skills.sh ↗ GitHub repository ↗

Summary

  • Extract message body and headers from Gmail using message IDs.
  • Reads individual Gmail messages by ID and returns body content in plain text or HTML format Optionally includes message headers (From, To, Subject, Date) in output Supports multiple output formats (text, json) and automatically converts HTML-only messages to plain text Handles multipart messages and base64 decoding; includes dry-run mode for testing requests

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

gmail-workflows Similar name
claude-office-skills/skills

Automate Gmail with intelligent workflows - attachment management, email organization, auto-arc…

4.3K installs
gmail-skill Similar name
idanbeck/claude-skills

Read, search, send, and draft Gmail emails and Google contacts. Use when the user asks to check…

3.5K installs
gmail Similar name
membranedev/application-skills

Gmail integration. Manage communication data, records, and workflows. Use when the user wants t…

779 installs
gws-gmail Similar name
streakyc/googleworkspacecli

Gmail: Send, read, and manage email.

25 installs
gws-gmail-send Similar name
streakyc/googleworkspacecli

Gmail: Send an email.

25 installs
gws-gmail-reply Similar name
streakyc/googleworkspacecli

Gmail: Reply to a message (handles threading automatically).

25 installs

Security audits

Partner security reviews for this skill.

agent-trust-hub SAFE

Analyzed Mar 31, 2026

This skill is a utility for reading Gmail messages using the official googleworkspace gws CLI tool. No malicious code, obfuscation, or unauthorized data access patterns were identified. While handling email content involves processing untrusted data, this is the intended purpose of the skill.

snyk MEDIUM

Analyzed Mar 31, 2026

[MEDIUM] W011: Third-party content exposure detected (indirect prompt injection risk).

socket Score 0.9000 · 0 alerts

Analyzed Mar 31, 2026

  • license 1
  • maintenance 1
  • quality 0.9
  • supply chain 1
  • vulnerability 1

0 alerts

Also in this package

Other skills from googleworkspace/cli · top by installs.

npx skills add googleworkspace/cli
gws-gmail 74.7K gws-gmail-send 69.5K gws-drive 68K gws-shared 59.4K gws-calendar 55.1K gws-sheets 52.5K gws-docs 52K gws-sheets-read 45.1K gws-docs-write 44.6K gws-calendar-agenda 44.2K

Browse all from googleworkspace/cli

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 30.8K
License LICENSE
Default branch main
Open issues 129
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version0.22.5
Declared agents clawdbot
More metadata
version
0.22.5
openclaw
{"category":"productivity","requires":{"bins":["gws"]},"cliHelp":"gws gmail +read --help"}

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 1,400 B
  • docs SUMMARY.md 76 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 37,315 installs

SKILL.md

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