gws: Google Workspace в руках агента через одну командную строку
Чтобы агент работал с Google Workspace, обычно пишут обёртки над десятком REST API. CLI gws строит команды на лету из Discovery Service Google и отвечает структурированным JSON, а прилагаемые скиллы объясняют агенту, как им пользоваться. По файлу путей их около 95: по одному на каждый API, помощники, рабочие сценарии, роли и рецепты.
Скиллы gws-gmail, gws-drive, gws-calendar, gws-sheets, gws-docs и gws-slides покрывают основные сервисы, плюс Chat, Forms, Keep, Meet и Tasks.
Помощники вроде +send, +reply, +triage, +agenda и +append отправляют письма, разбирают входящие, показывают встречи и дописывают строки в таблицы.
Сценарии gws-workflow собирают отчёт к планёрке, готовят к встрече, превращают письмо в задачу и делают недельную сводку.
Скиллы persona-* задают роль, например ассистента руководителя или ИТ-администратора, а recipe-* описывают готовые операции.
Команды поддерживают --dry-run для предпросмотра запроса и автопагинацию, а ответы всегда приходят в JSON.
Когда пригодится
Каждое утро разбираете входящие и календарь и хотите, чтобы агент присылал сводку непрочитанного и встреч дня.
Ведёте учёт в Google Таблицах и нужно, чтобы агент дописывал строки и строил отчёт без ручного копирования.
Администрируете домен Workspace и хотите смотреть журналы аудита и отчёты об использовании из терминала.
Попросите агента
Покажи непрочитанные письма за сегодня и мои встречи до обеда
Создай в Календаре встречу с командой на пятницу в 15:00 и пришли ссылку на Meet
Скачай все файлы из папки Drive «Договоры 2026» и найди, какие из них больше 50 МБ
Вопросы
Как подключить скиллы gws к агенту?
Установите CLI через npm install -g @googleworkspace/cli или бинарник с GitHub Releases, пройдите gws auth setup и добавьте скиллы командой npx skills add. Можно поставить и отдельный, например gws-drive.
Почему вход не проходит с сообщением «Access blocked»?
В настройках экрана согласия OAuth нужно добавить свой аккаунт в Test users. Кроме того, неподтверждённое приложение получает не больше примерно 25 областей доступа, поэтому выбирайте сервисы флагом -s.
Это официальный инструмент Google?
Нет. Репозиторий находится в организации googleworkspace, но в README сказано, что это не официально поддерживаемый продукт Google и до версии 1.0 возможны несовместимые изменения.
