gws-gmail-read — скилл для Claude: читает письма Gmail
Скилл достаёт тело или заголовки письма Gmail по его ID. Пригодится, когда агенту нужно заглянуть в конкретное сообщение, а не в весь ящик.
npx skills add googleworkspace/cli --skill gws-gmail-read -a claude-codeЧто делает gws-gmail-read
Скилл оборачивает команду gws gmail +read --id и отдаёт текст письма. По умолчанию вывод обычный текст, флаг --format json переключает на JSON, --html возвращает HTML-версию тела. С --headers в вывод попадут From, To, Subject и Date.
Внутри уже решены мелкие неудобства Gmail API: письма только с HTML конвертируются в текст, разбирается multipart/alternative, декодируется base64. Есть --dry-run — покажет запрос, который ушёл бы на сервер, и ничего не отправит.
Для работы нужен бинарник gws и настроенная авторизация из gws-shared; если файла нет, его создаёт gws generate-skills. Ставьте, если агенту регулярно нужно читать отдельные письма по ID. Если задача — разобрать весь ящик или искать по запросу, этот скилл тут ни при чём.
Какие задачи решает
- прочитать тело письма Gmail по ID
- вытащить From, To, Subject и Date из сообщения
- получить письмо в JSON и отдать его в jq
- превратить HTML-письмо в обычный текст
- посмотреть, какой запрос уйдёт в Gmail, без его отправки
Примеры запросов агенту
- прочитай письмо gws gmail +read --id 18f1a2b3c4d
- покажи заголовки этого письма: gws gmail +read --id 18f1a2b3c4d --headers
- достань тело письма в json: gws gmail +read --id 18f1a2b3c4d --format json | jq '.body'
Как установить gws-gmail-read
1Через Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-gmail-read -a claude-code2Вручную: положить файлы
~/.claude/skills/gws-gmail-read/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/gws-gmail-read/
1Через Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-gmail-read -a codex2Вручную: положить файлы
.agents/skills/gws-gmail-read/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-gmail-read -a cursor2Вручную: положить файлы
.cursor/skills/gws-gmail-read/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install googleworkspace/cli gws-gmail-read2Вручную: положить файлы
.github/skills/gws-gmail-read/SKILL.md1Через Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-gmail-read -a gemini-cli2Командой платформы
gemini skills install https://github.com/googleworkspace/cli --path skills/gws-gmail-readВручную: положить файлы
.devin/skills/gws-gmail-read/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-gmail-read -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
Из того же набора95
Весь набор →Похожие
Вопросы о gws-gmail-read
Как установить gws-gmail-read в Claude?
Выполните npx skills add googleworkspace/cli --skill gws-gmail-read -a claude-code. Файл скилла появится в ~/.claude/skills/gws-gmail-read/SKILL.md.
Что делает gws-gmail-read?
Читает письмо Gmail по ID и возвращает его тело или заголовки. HTML-письма автоматически переводятся в текст.
Что нужно для работы скилла?
Бинарник gws в системе и авторизация из gws-shared. Без этого файла запустите gws generate-skills.
Исходный текст
SKILL.md · Apache-2.0
---
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
```bash
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
```bash
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
© googleworkspace · Apache-2.0 · googleworkspace/cli
