gws
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Установка
npm install -g @googleworkspace/cliСкачивает бинарник из GitHub Releases. Также есть brew install googleworkspace-cli.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
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-*.
Проверка безопасности
- Получает OAuth-доступ к почте, файлам и календарю
- Может отправлять письма и изменять документы
Коротко о README
README описывает установку бинарником, через npm, cargo, Nix или Homebrew и быстрый старт с gws auth setup. Подробно разобраны способы авторизации и их приоритет: токен, файл учетных данных, зашифрованные данные в системном хранилище ключей. Есть разделы про скиллы для агентов, расширение для Gemini CLI, переменные окружения и коды выхода. Проект помечен как неофициальный и находящийся в активной разработке.
Частые вопросы
Почему вход падает с ошибкой Access blocked?
Для OAuth-приложения в тестовом режиме нужно добавить свой аккаунт в список Test users на экране согласия.
Как использовать в CI без браузера?
Пройдите вход на машине с браузером, выгрузите учетные данные через gws auth export --unmasked и укажите файл в GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE.
Похожие
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI
Официальные плагины Anthropic для офисных ролей: продажи, поддержка, продукт, маркетинг, юристы, финансы, данные и поиск по компании
MCP-сервер для Jira и Confluence в облаке и на собственных серверах: поиск, создание и правка задач и страниц