---
id: daily-gws-gmail-read
name: "gws-gmail-read"
url: https://skills.yangsir.net/skill/daily-gws-gmail-read
author: googleworkspace
domain: ai-productivity-automation
tags: ["gmail", "email", "api-integration", "message-parsing"]
install_count: 15200
rating: 4.50 (23 reviews)
github: https://github.com/googleworkspace/cli
---

# gws-gmail-read

> 通过消息ID从Gmail提取邮件正文和头部信息，支持纯文本和HTML格式返回

**Stats**: 15,200 installs · 4.5/5 (23 reviews)

## Before / After 对比

### Gmail邮件内容读取

**Before**:

手动登录Gmail网页端逐封查看邮件，复制粘贴正文内容，需要反复切换窗口，处理大量邮件时效率极低且容易遗漏关键信息

**After**:

通过消息ID直接调用技能批量读取邮件正文和头部信息，自动返回结构化内容，支持纯文本和HTML两种格式，快速集成到工作流

| Metric | Before | After | Change |
|---|---|---|---|
| 单封邮件处理时间 | 3min | 0.5min | -83% |

## Readme

# gws-gmail-read

**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

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](https://github.com/googleworkspace/cli/blob/HEAD/skills/gws-gmail-read/../gws-shared/SKILL.md) — Global flags and auth

- [gws-gmail](https://github.com/googleworkspace/cli/blob/HEAD/skills/gws-gmail-read/../gws-gmail/SKILL.md) — All send, read, and manage email commands

Weekly Installs422Repository[googleworkspace/cli](https://github.com/googleworkspace/cli)GitHub Stars21.4KFirst Seen2 days agoSecurity Audits[Gen Agent Trust HubPass](/googleworkspace/cli/gws-gmail-read/security/agent-trust-hub)[SocketPass](/googleworkspace/cli/gws-gmail-read/security/socket)[SnykWarn](/googleworkspace/cli/gws-gmail-read/security/snyk)Installed onopencode415codex414gemini-cli410cursor410kimi-cli409amp409

---
*Source: https://skills.yangsir.net/skill/daily-gws-gmail-read*
*Markdown mirror: https://skills.yangsir.net/api/skill/daily-gws-gmail-read/markdown*