Google Workspace CLI Assistant

Оптимизируйте рабочий процесс с gog для Claude Code. Управляйте Gmail, Календарем, Таблицами и Диском прямо из терминала с помощью этого мощного AI-скилла.

Продуктивность и workflow ★ 228,567 GitHub (228,567 ★)

Навык gog позволяет Claude управлять всей экосистемой Google Workspace прямо из командной строки. Он предоставляет комплексные инструменты для поиска и отправки писем в Gmail, управления событиями календаря с настраиваемой цветовой кодировкой, взаимодействия с данными Google Sheets через JSON, а также доступа к файлам в Drive или Docs. Устраняя разрыв между разработкой с помощью ИИ и личной продуктивностью, этот навык позволяет автоматизировать административные задачи, получать данные из электронных таблиц для анализа или планировать встречи, не покидая среду разработки.

Ключевые особенности

01Полный контроль над календарем: создание, обновление и цветовая кодировка событий.

02Управление контактами для быстрого поиска информации о коллегах и клиентах.

03Полноценное управление Gmail: расширенный поиск, отправка, черновики и ответы в ветках.

04Двусторонняя интеграция с Google Sheets через JSON для чтения и добавления данных.

05Доступ к Drive и Docs: поиск файлов и экспорт содержимого документов в текст.

06228,567 звезд на GitHub

Варианты использования

01Управление расписанием и проверка доступности без переключения окон.

02Получение данных из Google Sheets для использования в качестве контекста при решении задач по разработке или анализе данных.

03Автоматизация ежедневных отчетов о статусе или последующих действий после встреч прямо из CLI.

name

description

homepage

metadata

gog

Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.

https://gogcli.sh

openclaw

emoji

requires

install

🎮

bins

gog

kind

formula

bins

label

brew

steipete/tap/gogcli

gog

Install gog (brew)

gog

Use gog for Gmail/Calendar/Drive/Contacts/Sheets/Docs. Requires OAuth setup.

Setup (once)

gog auth credentials /path/to/client_secret.json
gog auth add you@gmail.com --services gmail,calendar,drive,contacts,docs,sheets
gog auth list

Common commands

Gmail search: gog gmail search 'newer_than:7d' --max 10
Gmail messages search (per email, ignores threading): gog gmail messages search "in:inbox from:ryanair.com" --max 20 --account you@example.com
Gmail send (plain): gog gmail send --to a@b.com --subject "Hi" --body "Hello"
Gmail send (multi-line): gog gmail send --to a@b.com --subject "Hi" --body-file ./message.txt
Gmail send (stdin): gog gmail send --to a@b.com --subject "Hi" --body-file -
Gmail send (HTML): gog gmail send --to a@b.com --subject "Hi" --body-html "Hello"
Gmail draft: gog gmail drafts create --to a@b.com --subject "Hi" --body-file ./message.txt
Gmail send draft: gog gmail drafts send <draftId>
Gmail reply: gog gmail send --to a@b.com --subject "Re: Hi" --body "Reply" --reply-to-message-id <msgId>
Calendar list events: gog calendar events <calendarId> --from <iso> --to <iso>
Calendar create event: gog calendar create <calendarId> --summary "Title" --from <iso> --to <iso>
Calendar create with color: gog calendar create <calendarId> --summary "Title" --from <iso> --to <iso> --event-color 7
Calendar update event: gog calendar update <calendarId> <eventId> --summary "New Title" --event-color 4
Calendar show colors: gog calendar colors
Drive search: gog drive search "query" --max 10
Contacts: gog contacts list --max 20
Sheets get: gog sheets get <sheetId> "Tab!A1:D10" --json
Sheets update: gog sheets update <sheetId> "Tab!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED
Sheets append: gog sheets append <sheetId> "Tab!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS
Sheets clear: gog sheets clear <sheetId> "Tab!A2:Z"
Sheets metadata: gog sheets metadata <sheetId> --json
Docs export: gog docs export <docId> --format txt --out /tmp/doc.txt
Docs cat: gog docs cat <docId>

Calendar Colors

Use gog calendar colors to see all available event colors (IDs 1-11)
Add colors to events with --event-color <id> flag
Event color IDs (from gog calendar colors output):
- 1: #a4bdfc
- 2: #7ae7bf
- 3: #dbadff
- 4: #ff887c
- 5: #fbd75b
- 6: #ffb878
- 7: #46d6db
- 8: #e1e1e1
- 9: #5484ed
- 10: #51b749
- 11: #dc2127

Email Formatting

Prefer plain text. Use --body-file for multi-paragraph messages (or --body-file - for stdin).
Same --body-file pattern works for drafts and replies.
--body does not unescape \n. If you need inline newlines, use a heredoc or $'Line 1\n\nLine 2'.
Use --body-html only when you need rich formatting.
HTML tags:  for paragraphs,   for line breaks,  for bold,  for italic, <a href="https://github.com/openclaw/openclaw/blob/2196456d4a44d1e54651dce5ee89046a829185e5/skills/gog/url"> for links, <ul>/<li> for lists.

Example (plain text via stdin):

gog gmail send --to recipient@example.com \
  --subject "Meeting Follow-up" \
  --body-file - <<'EOF'
Hi Name,

Thanks for meeting today. Next steps:
- Item one
- Item two

Best regards,
Your Name
EOF

Example (HTML list):

gog gmail send --to recipient@example.com \
  --subject "Meeting Follow-up" \
  --body-html "<p>Hi Name,</p><p>Thanks for meeting today. Here are the next steps:</p><ul><li>Item one</li><li>Item two</li></ul><p>Best regards,<br>Your Name</p>"

Notes

Set GOG_ACCOUNT=you@gmail.com to avoid repeating --account.
For scripting, prefer --json plus --no-input.
Sheets values can be passed via --values-json (recommended) or as inline rows.
Docs supports export/cat/copy. In-place edits require a Docs API client (not in gog).
Confirm before sending mail or creating events.
gog gmail search returns one row per thread; use gog gmail messages search when you need every individual email returned separately.

Что это

Google Workspace CLI Assistant (gog) — это консольная утилита для управления сервисами Google Workspace прямо из терминала. Она даёт возможность работать с Gmail, Календарём, Диском, Контактами, Таблицами и Документами без веб-интерфейса. Инструмент ориентирован на разработчиков, DevOps-инженеров и всех, кто хочет автоматизировать рутинные операции с Google-аккаунтом: поиск писем, отправку сообщений, создание событий, чтение таблиц и экспорт документов.

Как работает

🔑 Настройка OAuth и авторизация

Перед первым использованием нужно пройти OAuth-аутентификацию. Для этого потребуется файл client_secret.json из Google Cloud Console. Процесс одноразовый:

Загрузите учётные данные: gog auth credentials /path/to/client_secret.json
Добавьте аккаунт с нужными сервисами: gog auth add you@gmail.com --services gmail,calendar,drive,contacts,docs,sheets
Просмотрите список авторизованных аккаунтов: gog auth list

После этого можно указывать аккаунт через флаг --account или задать переменную окружения GOG_ACCOUNT, чтобы не повторять его в каждой команде.

📧 Gmail: поиск, отправка, черновики, ответы

Утилита позволяет выполнять все основные операции с почтой:

Поиск писем — gog gmail search 'newer_than:7d' --max 10 (возвращает по одному результату на тред). Для поиска отдельных сообщений (без группировки в треды) используйте gog gmail messages search.
Отправка — поддерживает обычный текст (--body), многострочный текст из файла (--body-file ./message.txt) или из stdin (--body-file -), а также HTML-письма (--body-html).
Черновики — создание (gog gmail drafts create) и отправка (gog gmail drafts send draftId``).
Ответы — можно ответить на конкретное письмо, указав --reply-to-message-id msgId``.

Пример отправки письма с многострочным текстом через heredoc:

gog gmail send --to recipient@example.com \
  --subject "Встреча" \
  --body-file - << 'EOF'
Привет,

Спасибо за встречу.

Следующие шаги:
- Пункт один
- Пункт два

С уважением,
Имя
EOF

📅 Календарь: просмотр, создание, обновление событий, цвета

Список событий — gog calendar events calendarId--fromiso--toiso``.
Создание события — gog calendar create calendarId--summary "Заголовок" --fromiso--toiso. Можно добавить цвет через `--event-color `id.
Обновление — gog calendar update calendarId eventId --summary "Новый заголовок" --event-color 4.
Просмотр доступных цветов — gog calendar colors (выводит ID и hex-коды, например 1: #a4bdfc).

📁 Drive: поиск файлов

Поиск на Google Диске выполняется командой gog drive search "query" --max 10. Результаты можно использовать в скриптах для дальнейшей обработки.

📇 Контакты: список

Получить список контактов: gog contacts list --max 20. Полезно для интеграции с другими сервисами.

📊 Sheets: чтение, запись, добавление, очистка

Работа с Google Таблицами:

Чтение — gog sheets get sheetId "Tab!A1:D10" --json (вывод в JSON для скриптов).
Запись — gog sheets update sheetId "Tab!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED.
Добавление строк — gog sheets append sheetId "Tab!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS.
Очистка диапазона — gog sheets clear sheetId "Tab!A2:Z".
Метаданные — gog sheets metadata sheetId --json.

📝 Docs: экспорт, просмотр

С Google Документами можно только читать и экспортировать:

Экспорт — gog docs export docId --format txt --out /tmp/doc.txt.
Просмотр содержимого — gog docs cat docId``.

Редактирование документов на месте не поддерживается (требуется Docs API).

⚙️ Полезные советы

Переменная окружения GOG_ACCOUNT=you@gmail.com избавляет от повторения --account.
Для скриптов используйте флаги --json и --no-input, чтобы получать структурированный вывод и избежать интерактивных запросов.
При отправке писем с многострочным текстом предпочтительнее --body-file (файл или stdin), так как --body не обрабатывает экранирование \n.
HTML-письма поддерживают базовые теги: p, br, strong, em, a, ul`/`li.
Перед отправкой почты или созданием событий утилита запрашивает подтверждение — это защита от случайных действий.

Когда использовать

Автоматизация рутины — например, ежедневная рассылка отчётов, создание событий по расписанию, бэкап данных из Таблиц.
Интеграция в CI/CD — можно добавить шаги, которые отправляют уведомления через Gmail или обновляют статус в Таблице.
Управление без GUI — когда нужно быстро найти письмо, создать встречу или выгрузить документ, не открывая браузер.
Скриптовая обработка — комбинируйте команды gog с jq, grep и другими утилитами для построения сложных пайплайнов.

Важно знать

Для работы требуется OAuth-авторизация — файл client_secret.json и разрешения для каждого сервиса. Без этого ни одна команда не выполнится.
Подтверждение действий — отправка писем и создание событий требуют интерактивного подтверждения (если не указан --no-input). Это безопасно, но учитывайте при автоматизации.
Ограничения Docs — gog не поддерживает редактирование содержимого документов, только экспорт и чтение. Для изменений нужен отдельный клиент Docs API.
Форматирование писем — для многострочных сообщений используйте --body-file или heredoc, а не --body с \n.
Цвета событий — ID цветов можно получить командой gog calendar colors; они соответствуют стандартной палитре Google Календаря.

Установка одной командой.

npx skillfish add openclaw/openclaw gog

Источник: https://mcpmarket.com/tools/skills/google-workspace-cli-assistant