gws-gmail — скилл для Claude: почта Gmail из терминала
Скилл даёт агенту доступ к Gmail: отправить письмо, прочитать входящие, ответить в ветке. Пригодится, если работа с почтой идёт через CLI gws.
npx skills add googleworkspace/cli --skill gws-gmail -a claude-codeЧто делает gws-gmail
Скилл оборачивает Gmail API в команды вида gws gmail [flags]. Внутри — готовые хелперы: +send для отправки, +triage для сводки непрочитанных, +reply и +reply-all с автоматической обработкой ветки, +forward, +read для извлечения тела или заголовков, +watch для потока новых писем в NDJSON. Плюс доступ к ресурсам API: users, drafts, history, labels, messages, settings, threads.
Перед вызовом метода скилл советует посмотреть его схему через gws schema gmail.. — оттуда берутся обязательные параметры и типы для флагов --params и --json. Для авторизации, глобальных флагов и правил безопасности нужен файл ../gws-shared/SKILL.md; если его нет, генерируйте командой gws generate-skills. Без установленного бинарника gws скилл не заработает.
Ставить стоит тем, кто уже держит почтовые задачи в терминале и хочет, чтобы агент читал и отправлял письма без переключения в браузер. Если Gmail у вас не основной ящик или вы не готовы давать агенту доступ к переписке — проходите мимо.
Какие задачи решает
- отправить письмо из терминала без открытия браузера
- собрать сводку непрочитанных с отправителем, темой и датой
- ответить в ветке с сохранением threading
- переслать письмо новым получателям
- читать новые письма потоком в NDJSON
Примеры запросов агенту
- отправь письмо на [email protected] с темой «Деплой готов»
- покажи сводку непрочитанных за сегодня
- ответь на последнее письмо от клиента и сохрани ветку
Как установить gws-gmail
1Через Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-gmail -a claude-code2Вручную: положить файлы
~/.claude/skills/gws-gmail/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/gws-gmail/
1Через Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-gmail -a codex2Вручную: положить файлы
.agents/skills/gws-gmail/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-gmail -a cursor2Вручную: положить файлы
.cursor/skills/gws-gmail/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install googleworkspace/cli gws-gmail2Вручную: положить файлы
.github/skills/gws-gmail/SKILL.md1Через Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-gmail -a gemini-cli2Командой платформы
gemini skills install https://github.com/googleworkspace/cli --path skills/gws-gmailВручную: положить файлы
.devin/skills/gws-gmail/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add googleworkspace/cli --skill gws-gmail -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
Из того же набора95
Весь набор →Похожие
Вопросы о gws-gmail
Как установить gws-gmail в Claude?
Выполните npx skills add googleworkspace/cli --skill gws-gmail -a claude-code. Файл скилла появится по пути ~/.claude/skills/gws-gmail/SKILL.md.
Что делает gws-gmail?
Даёт агенту команды для отправки, чтения и разбора почты Gmail через CLI gws, включая ответы в ветке и поток новых писем.
Что нужно для работы скилла?
Установленный бинарник gws и файл ../gws-shared/SKILL.md с настройками авторизации. Если его нет, создайте командой gws generate-skills.
Исходный текст
SKILL.md · Apache-2.0
---
name: gws-gmail
description: "Gmail: Send, read, and manage email."
metadata:
version: 0.22.5
openclaw:
category: "productivity"
requires:
bins:
- gws
cliHelp: "gws gmail --help"
---
# gmail (v1)
> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.
```bash
gws gmail <resource> <method> [flags]
```
## Helper Commands
| Command | Description |
|---------|-------------|
| [`+send`](../gws-gmail-send/SKILL.md) | Send an email |
| [`+triage`](../gws-gmail-triage/SKILL.md) | Show unread inbox summary (sender, subject, date) |
| [`+reply`](../gws-gmail-reply/SKILL.md) | Reply to a message (handles threading automatically) |
| [`+reply-all`](../gws-gmail-reply-all/SKILL.md) | Reply-all to a message (handles threading automatically) |
| [`+forward`](../gws-gmail-forward/SKILL.md) | Forward a message to new recipients |
| [`+read`](../gws-gmail-read/SKILL.md) | Read a message and extract its body or headers |
| [`+watch`](../gws-gmail-watch/SKILL.md) | Watch for new emails and stream them as NDJSON |
## API Resources
### users
- `getProfile` — Gets the current user's Gmail profile.
- `stop` — Stop receiving push notifications for the given user mailbox.
- `watch` — Set up or update a push notification watch on the given user mailbox.
- `drafts` — Operations on the 'drafts' resource
- `history` — Operations on the 'history' resource
- `labels` — Operations on the 'labels' resource
- `messages` — Operations on the 'messages' resource
- `settings` — Operations on the 'settings' resource
- `threads` — Operations on the 'threads' resource
## Discovering Commands
Before calling any API method, inspect it:
```bash
# Browse resources and methods
gws gmail --help
# Inspect a method's required params, types, and defaults
gws schema gmail.<resource>.<method>
```
Use `gws schema` output to build your `--params` and `--json` flags.
© googleworkspace · Apache-2.0 · googleworkspace/cli
