К основному содержанию
скилл CX Codex

gws — скилл для Claude Code: Google Workspace через CLI

Скилл для работы с Gmail, Calendar, Drive, Sheets и другими сервисами Google Workspace прямо из ИИ-кодинга. Нужен установленный gws CLI и OAuth-токен для Google API.

MIT 235 установок ★ 414 обновлён 2026-10-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add glebis/claude-skills --skill gws -a claude-code
Открыть на GitHub

Что делает gws

gws даёт агенту доступ к основным операциям Google Workspace через командную строку. Внутри — wrapper над официальным Google API: поиск и отправка писем, просмотр и создание событий в календаре, загрузка и скачивание файлов с Drive, чтение и добавление строк в Sheets, отправка сообщений в Chat, работа с контактами.

Скилл предоставляет шортканды вроде gws gmail +triage, gws calendar +agenda, gws drive +upload, которые упрощают базовые действия. Для сложных запросов можно использовать полные API-команды с --params и --json. Поддерживает разные форматы вывода (JSON, таблица, YAML, CSV) и пакетные операции.

Предварительно надо установить gws CLI и пройти OAuth-авторизацию в Google. Некоторые операции (фильтры Gmail) требуют расширенных прав и дополнительной настройки. Скилл работает с RFC3339-временем для календаря и требует корректного формата дат.

Какие задачи решает

  • Проверить непрочитанные письма и отсортировать их по ярлыкам
  • Узнать расписание на день и подготовиться к следующей встречу
  • Загрузить файл на Drive и поделиться им с коллегой
  • Добавить данные в Google Sheets или прочитать диапазон ячеек
  • Отправить сообщение в Google Chat из автоматизации

Примеры запросов агенту

  • Проверь мои непрочитанные письма и выведи их таблицей
  • Создай событие в календаре на завтра с 14:00 до 15:00 «Синк с командой»
  • Загрузи файл report.pdf на Drive в папку с ID abc123

Как установить gws

1Через Skills CLI (Vercel)

npx skills add glebis/claude-skills --skill gws -a claude-code

2Вручную: положить файлы

~/.claude/skills/gws/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/gws/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о gws

Как установить gws в Claude Code?

Выполни npx skills add glebis/claude-skills --skill gws -a claude-code, затем открой ~/.claude/skills/gws/SKILL.md для проверки.

Что делает gws?

Даёт доступ к Gmail, Calendar, Drive, Sheets, Docs, Tasks, Chat и другим Google Workspace-сервисам через CLI. Позволяет искать письма, создавать события, загружать файлы, добавлять строки в таблицы и отправлять сообщения.

Что нужно перед установкой?

Установленный gws CLI и OAuth-токен Google API. Некоторые операции требуют расширенных разрешений в Google Cloud Console.

Исходный текст

SKILL.md · MIT
---
name: gws
description: This skill should be used when interacting with Google Workspace services via the gws CLI — Gmail (search, triage, send, labels, filters, drafts), Calendar (agenda, events, Meet conferencing), Drive (upload, list, share, download), Sheets (read, append), Docs, Tasks, Chat (send), People/Contacts, and cross-service workflows (standup, meeting prep, weekly digest, email-to-task). Triggers on queries like "check my email", "search Gmail", "send email", "calendar agenda", "create calendar event", "upload to Drive", "read spreadsheet", "create a task", "triage inbox", "find contact", "post to Chat".
---

# Google Workspace CLI (gws)

CLI for Gmail, Calendar, Drive, Sheets, Docs, Slides, Tasks, People, Chat, Meet, Forms, Keep, Admin, and cross-service workflows.

Binary: `/opt/homebrew/bin/gws`

## Command Pattern

```
gws <service> <resource> [sub-resource] <method> [flags]
```

Every command accepts:
- `--params <JSON>` — URL/query parameters
- `--json <JSON>` — request body (POST/PATCH/PUT)
- `--upload <PATH>` — file to upload as media content
- `--output <PATH>` — path for binary responses (downloads)
- `--format json|table|yaml|csv` — output format (default: json)
- `--page-all` / `--page-limit N` — auto-paginate
- `--dry-run` — validate locally without sending

## Quick Reference — Helper Commands (prefer these)

| Command | Purpose | R/W |
|---|---|---|
| `gws gmail +triage [--max N] [--query Q]` | Unread inbox summary | R |
| `gws gmail +send --to EMAIL --subject S --body T` | Send plaintext email | W |
| `gws gmail +watch --project GCP` | Stream new emails (Pub/Sub) | R |
| `gws calendar +agenda [--today\|--tomorrow\|--week\|--days N]` | Upcoming events | R |
| `gws calendar +insert --summary T --start ISO --end ISO` | Create event | W |
| `gws drive +upload FILE [--parent ID] [--name N]` | Upload file | W |
| `gws sheets +read --spreadsheet ID --range R` | Read range (e.g. `Sheet1!A1:D10`) | R |
| `gws sheets +append --spreadsheet ID --values "a,b,c"` | Append row (or `--json-values`) | W |
| `gws docs +write --document ID --text T` | Append text to doc | W |
| `gws chat +send --space spaces/ID --text T` | Post to Chat space | W |
| `gws workflow +standup-report` | Today's meetings + open tasks | R |
| `gws workflow +meeting-prep [--calendar ID]` | Next meeting details | R |
| `gws workflow +email-to-task --message-id ID` | Email → Task | W |
| `gws workflow +weekly-digest` | Week's meetings + unread | R |
| `gws workflow +file-announce --file-id ID --space SPACE` | Announce file in Chat | W |

## Common Patterns

### Gmail
```bash
# Triage unread (table for humans)
gws gmail +triage --max 10 --format table

# Search
gws gmail users messages list --params '{"userId":"me","q":"from:amazon newer_than:7d","maxResults":5}'

# Read full message
gws gmail users messages get --params '{"userId":"me","id":"MSG_ID","format":"full"}'

# Read headers only (faster)
gws gmail users messages get --params '{"userId":"me","id":"MSG_ID","format":"metadata","metadataHeaders":["Subject","From","Date"]}'

# Archive (remove INBOX)
gws gmail users messages modify --params '{"userId":"me","id":"MSG_ID"}' --json '{"removeLabelIds":["INBOX"]}'

# Trash
gws gmail users messages trash --params '{"userId":"me","id":"MSG_ID"}'

# Bulk label
gws gmail users messages batchModify --params '{"userId":"me"}' --json '{"ids":["ID1","ID2"],"addLabelIds":["Label_123"]}'
```

### Calendar
```bash
# Today (Europe/Berlin default works with RFC3339 +02:00/+01:00)
gws calendar +agenda --today --format table

# Create simple event
gws calendar +insert \
  --summary 'AGENCY Meetup' \
  --start '2026-04-14T18:00:00+02:00' \
  --end '2026-04-14T19:00:00+02:00' \
  --location 'https://us02web.zoom.us/j/8991032224' \
  --description 'Zoom: https://us02web.zoom.us/j/8991032224'

# Event WITH Google Meet link (helper doesn't support — use raw)
gws calendar events insert \
  --params '{"calendarId":"primary","conferenceDataVersion":1}' \
  --json '{
    "summary":"Sync",
    "start":{"dateTime":"2026-04-15T14:00:00+02:00"},
    "end":{"dateTime":"2026-04-15T15:00:00+02:00"},
    "conferenceData":{"createRequest":{"requestId":"req-'$(date +%s)'","conferenceSolutionKey":{"type":"hangoutsMeet"}}}
  }'

# Update event
gws calendar events patch --params '{"calendarId":"primary","eventId":"EID"}' --json '{"summary":"New title"}'

# Delete
gws calendar events delete --params '{"calendarId":"primary","eventId":"EID"}'

# List all calendars
gws calendar calendarList list --format table
```

### Drive
```bash
# Upload to root
gws drive +upload ./report.pdf

# Upload to folder
gws drive +upload ./data.csv --parent FOLDER_ID --name 'Sales Data.csv'

# Search files
gws drive files list --params '{"q":"name contains \"report\" and mimeType=\"application/pdf\"","pageSize":10}'

# Download
gws drive files get --params '{"fileId":"FID","alt":"media"}' --output ./local.pdf

# Create folder
gws drive files create --json '{"name":"MyFolder","mimeType":"application/vnd.google-apps.folder"}'

# Share with user
gws drive permissions create --params '{"fileId":"FID"}' --json '{"role":"reader","type":"user","emailAddress":"[email protected]"}'
```

### Sheets
```bash
# Read
gws sheets +read --spreadsheet SID --range 'Sheet1!A1:D10' --format table

# Append single row (simple values)
gws sheets +append --spreadsheet SID --values 'Alice,100,true'

# Append multiple rows
gws sheets +append --spreadsheet SID --json-values '[["a","b"],["c","d"]]'
```

### Tasks
```bash
gws tasks tasklists list
gws tasks tasks list --params '{"tasklist":"@default"}'
gws tasks tasks insert --params '{"tasklist":"@default"}' --json '{"title":"My task","notes":"Details","due":"2026-04-20T00:00:00Z"}'
gws tasks tasks patch --params '{"tasklist":"@default","task":"TID"}' --json '{"status":"completed"}'
```

### Chat
```bash
# Find space
gws chat spaces list --format table

# Post message
gws chat +send --space spaces/AAAAxxxx --text 'Hello team!'
```

### People / Contacts
```bash
gws people people connections list --params '{"resourceName":"people/me","personFields":"names,emailAddresses","pageSize":100}'
gws people people searchContacts --params '{"query":"John","readMask":"names,emailAddresses"}'
```

## Critical Notes

- **userId**: Every Gmail raw call needs `"userId":"me"` in params.
- **RFC3339 times**: Calendar uses full ISO with offset (`2026-04-14T18:00:00+02:00`). "Z" for UTC.
- **Meet links**: `+insert` does NOT add conferencing — use raw `events.insert` with `conferenceDataVersion=1` and `conferenceData.createRequest`.
- **Pagination**: `--page-all` emits NDJSON (one JSON object per page). `--page-limit N` caps pages.
- **Schema discovery**: `gws schema <service>.<resource>.<method>` — e.g. `gws schema gmail.users.messages.list`.
- **Filters**: `gmail.settings.basic` scope required — special manual OAuth flow (see `references/api_reference.md`).
- **Write confirmation**: Always confirm with user before `+send`, `+insert`, `+email-to-task`, `+file-announce`, `drive files delete`, `events delete`, `messages trash`.
- **Format choice**: `--format table` for human-readable summaries; default `json` for scripting/piping to `jq`.

## OAuth Setup

- GCP project: `n8n-automations-454016`
- Credentials: `~/.config/gws/credentials.json`
- Configured scopes: `gmail.modify`, `gmail.settings.basic`, `drive`, `spreadsheets`, `tasks`, `calendar`, `documents`, `chat.messages`, `contacts.readonly`
- `gmail.settings.basic` scope needs manual OAuth (Python localhost listener on port 8085) — `gws auth login --scopes` cannot request it directly.

## Full API Reference

For full command inventory, all raw API calls, pagination, labels, drafts, filters, and admin APIs, see `references/api_reference.md`.

© glebis · MIT · glebis/claude-skills

Похожие скиллы

Все скиллы по теме «Автоматизация и no-code: n8n, Zapier, Make» →
google-workspace mitsuhiko Скилл даёт агенту доступ к Google Workspace (Gmail, Drive, Docs, Calendar, Sheets и другим) через локальные скрипты. Подходит, если вам нужно автоматизировать работу с гугловскими сервисами прямо из IDE. CX Codex +1 108установок persona-researcher официальный googleworkspace Скилл persona-researcher настраивает роль исследователя для работы с Google Workspace. Он помогает вести заметки в Docs, фиксировать данные в Sheets и рассылать материалы коллегам. CX Codex +1 32 400установок google-workspace-cli Alireza Rezvani Скилл google-workspace-cli для Claude Code управляет Google Workspace через CLI gws: отправляет письма, работает с файлами и таблицами, настраивает календарь. Автоматизирует эти задачи в командах. CX Codex +1 636установок persona-team-lead официальный googleworkspace Скилл persona-team-lead помогает вести командные ритуалы, готовить встречи и распределять задачи через Google Workspace. Подходит для регулярной работы тимлида. CX Codex +1 31 400установок gog openclaw Задаёт агенту правила работы с CLI gog в Gmail, Calendar, Drive, Contacts, Sheets и Docs. Агент выполняет действия в Google Workspace из терминала. CX Codex +1 8 500установок gws-gmail-triage davila7 Команда gws-gmail-triage показывает сводку непрочитанных писем Gmail с отправителем, темой и датой через утилиту Google Workspace CLI. CX Codex +1 78установок

Из того же набора51

Весь набор →
zoom Скилл для управления встречами Zoom и облачными записями через API. Создавайте, обновляйте и удаляйте встречи, ищите записи с расшифровками и ссылками на загрузку. CX Codex +1 252установок fathom Загружает из Fathom API встречи, транскрипты, саммари и action items. Автоматизирует работу с записями совещаний в процессе кодинга. CX Codex +1 249установок github-gist Публикует файлы и заметки в GitHub Gist. Создаёт ссылку на снипет или размещает Markdown. CX Codex +1 246установок balanced Скилл для многоперспективного анализа идей: находит сильные аргументы, проверяет логику, предлагает альтернативы. Запускается командой /balanced или фразой с запросом честной обратной связи. CX Codex +1 243установок llm-cli Скилл llm-cli для обработки текстов и файлов через CLI llm, поддерживающий OpenAI, Anthropic, Google Gemini и локальные модели Ollama. Выбирает модель интерактивно, сохраняет настройки, работает в режиме диалога или одноразовой обработки. CX Codex +1 235установок granola Получает заметки и расшифровки встреч из Granola и сохраняет их в Obsidian. Позволяет искать записи и передавать их на анализ. CX Codex +1 234установок chrome-history Скилл chrome-history для Claude Code ищет в истории Chrome по естественному языку и фильтрует результаты по датам, типу контента и ключевым словам. CX Codex +1 234установок meta Регистрирует обработчик команды /meta, чтобы запускать Claude Code Agent SDK прямо в каталоге бота telegram_agent и править его код из чата. CX Codex +1 228установок

Ещё в каталоге

Спонсоры проекта

Компании, которые помогают держать аналитику открытой