gws CLI
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
- 31 970 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Получает OAuth-доступ к почте, файлам и календарю
- Может отправлять письма и изменять документы
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/gwsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Получает OAuth-доступ к почте, файлам и календарю
- Может отправлять письма и изменять документы
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
gws строит набор команд на лету по Discovery Service Google, поэтому новые методы API появляются в нем без обновления. Любой ответ приходит в структурированном JSON, есть --dry-run, автопагинация и просмотр схемы метода через gws schema. В репозитории лежат больше сотни SKILL.md: по одному на каждый API, вспомогательные и готовые рецепты для Gmail, Drive, Docs, Calendar и Sheets. Поддерживаются интерактивный OAuth, сервисные аккаунты, готовые токены и экспорт учетных данных для CI.
Для кого. Для тех, кто хочет, чтобы агент работал с почтой, документами и календарем Google без своих интеграций.
Подходит, если
- Агенту нужно искать письма, файлы на Drive или события в календаре
- Нужно создавать таблицы и документы из скриптов или CI
- Хочется дать Gemini CLI или другому агенту доступ к Workspace одной установкой
Не подходит, если
- Работа идет в Яндекс 360 или другом офисном пакете
- Нельзя создать проект Google Cloud и OAuth-клиент
Пример запроса к агенту
Найди в Gmail письма от бухгалтерии за неделю и сложи вложения в папку на DriveОграничения
Это не официально поддерживаемый продукт Google, до версии 1.0 возможны несовместимые изменения. Нужны проект Google Cloud и OAuth-клиент, для неподтвержденного приложения Google ограничивает число scopes, поэтому набор recommended может не пройти. Доступность сервисов Google Workspace из России неоднородна.
Как отключить. Удалите бинарник gws или пакет @googleworkspace/cli, папку ~/.config/gws с учетными данными и установленные скиллы gws-*.
Частые вопросы
Почему вход падает с ошибкой Access blocked?
Для OAuth-приложения в тестовом режиме нужно добавить свой аккаунт в список Test users на экране согласия.
Как использовать в CI без браузера?
Пройдите вход на машине с браузером, выгрузите учетные данные через gws auth export --unmasked и укажите файл в GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыGoogle Workspace для Gemini CLI
Google Workspace Extension for Gemini CLI
Расширение Gemini CLI для работы с Google Docs, Sheets, Slides, Gmail, Chat, Calendar и Drive из терминала
Один MCP-сервер для Gmail, Календаря, Диска, Docs, Sheets, Slides, Forms, Tasks, Контактов, Chat и Apps Script с OAuth 2.1
GSuite MCP
mcp-gsuite
MCP-сервер для Gmail и Google Календаря на Python: поиск и чтение писем, черновики и ответы, события с участниками, несколько аккаунтов сразу
Google Docs MCP — Docs, Sheets, Drive, Gmail и Calendar
Google Docs MCP
MCP-сервер дает агенту Google Docs, Sheets, Drive, Gmail, Calendar и Apps Script: чтение, правка, письма и события; вход через OAuth
Набор бытовых скиллов для агента: веб-поиск, автоматизация браузера, Gmail, Google Календарь и Диск, расшифровка речи и субтитры YouTube
DingTalk Workspace CLI (dws)
DingTalk Workspace CLI
Официальный CLI DingTalk со скиллами для агентов: чаты, календарь, задачи, почта, документы и согласования организации из терминала
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| gws (эта запись) | нет | 31 970 | |
| DingTalk Workspace CLI (dws) | да | 3 843 | официальный CLI DingTalk со скиллами для агентов |
| HEY CLI | да | 420 | консоль и TUI сервиса HEY |
Коротко о README
README описывает установку бинарником, через npm, cargo, Nix или Homebrew и быстрый старт с gws auth setup. Подробно разобраны способы авторизации и их приоритет: токен, файл учетных данных, зашифрованные данные в системном хранилище ключей. Есть разделы про скиллы для агентов, расширение для Gemini CLI, переменные окружения и коды выхода. Проект помечен как неофициальный и находящийся в активной разработке.