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

google-workspace · mitsuhiko — скилл для Claude Code: доступ к Google API

Скилл даёт агенту доступ к Google Workspace (Gmail, Drive, Docs, Calendar, Sheets и другим) через локальные скрипты. Подходит, если вам нужно автоматизировать работу с гугловскими сервисами прямо из IDE.

Apache-2.0 108 установок ★ 3 224 обновлён 2026-09-27

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

Что делает google-workspace

google-workspace — это набор helper-скриптов, которые запускают API Google Workspace без MCP-сервера. Внутри два основных скрипта: scripts/auth.js для OAuth-логина и управления аккаунтами, и scripts/workspace.js для выполнения API-вызовов через JavaScript.

Скилл работает с несколькими аккаунтами одновременно. Каждый API-вызов требует флага --email, указывающего, от какого аккаунта действовать. Токены хранятся отдельно для каждого email в ~/.pi/google-workspace/tokens/. Перед первым использованием запустите node scripts/auth.js login --email [email protected] — зависимости установятся автоматически.

Для API-вызовов используйте node scripts/workspace.js exec с JavaScript-блоком внутри. Доступны методы workspace.call() для прямых API-запросов, workspace.service() для получения сервиса и workspace.whoAmI() для проверки текущего пользователя. Опциональные флаги: --timeout (по умолчанию 30000 мс, максимум 300000) и --scopes для указания разрешений.

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

  • Получить список файлов с Google Drive по критериям
  • Отправить письмо через Gmail и проверить статус доставки
  • Создать или обновить таблицу в Google Sheets
  • Выгрузить события календаря на период
  • Найти контакт в People API и обновить данные

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

  • Скачай первые 10 PDF-файлов с Диска, созданных после 2024 года
  • Посчитай количество непрочитанных писем с меткой invoice
  • Создай событие на завтра в 14:00 с приглашением [email protected]

Как установить google-workspace

1Через Skills CLI (Vercel)

npx skills add mitsuhiko/agent-stuff --skill google-workspace -a claude-code

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

~/.claude/skills/google-workspace/SKILL.md

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

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

Вопросы о google-workspace

Как установить google-workspace в Claude Code?

Выполните команду npx skills add mitsuhiko/agent-stuff --skill google-workspace -a claude-code, затем отредактируйте файл ~/.claude/skills/google-workspace/SKILL.md.

Что делает google-workspace?

Скилл предоставляет доступ к Google Workspace API (Drive, Docs, Gmail, Calendar, Sheets, Slides, Chat, People) через локальные скрипты. Вы можете писать JavaScript-код для автоматизации операций с гугловскими сервисами без использования MCP-сервера.

Могу ли я работать с несколькими гугл-аккаунтами одновременно?

Да, скилл работает с профилями по email. Каждый API-вызов требует флага --email [email protected]. Для перечисления всех авторизованных аккаунтов запустите node scripts/auth.js accounts.

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

SKILL.md · Apache-2.0
---
name: google-workspace
description: "Access Google Workspace APIs (Drive, Docs, Calendar, Gmail, Sheets, Slides, Chat, People) via local helper scripts without MCP. Handles OAuth login and direct API calls."
---

# Google Workspace

Use this skill for Google Workspace tasks (Gmail, Drive, Calendar, Docs, Sheets, etc.).

## Files

- `scripts/auth.js` — OAuth login/status/clear + account enumeration
- `scripts/workspace.js` — JavaScript execution based API runner

## Account model (multi-account)

This skill is **profile-based by email address**.

- There is **no default account**.
- Every API call must specify `--email <[email protected]>`.
- Tokens are stored per-email under `~/.pi/google-workspace/tokens/`.

Before running API calls, discover available signed-in accounts:

```bash
node scripts/auth.js accounts
```

## Usage

Always use `exec` and always provide `--email`.

```bash
node scripts/workspace.js exec --email [email protected] <<'JS'
const me = await workspace.whoAmI();
const files = await workspace.call('drive', 'files.list', {
  pageSize: 5,
  fields: 'files(id,name,mimeType)',
});
return { me, files: files.files };
JS
```

Available inside exec scripts:

- `auth` (authorized OAuth client)
- `google` (`googleapis` root)
- `workspace.accountEmail` (selected profile email)
- `workspace.call(service, methodPath, params, {version})`
- `workspace.service(service, {version})`
- `workspace.whoAmI()`

Optional flags:

- `--timeout <ms>` (default 30000, max 300000)
- `--scopes s1,s2`
- `--script 'return 42'`

## Agent guidance

1. Prefer one `exec` script per user request.
2. Keep payloads small (`fields`, `maxResults`, minimal props).
3. Use `Promise.all` for independent requests.
4. Never print token contents.
5. If the user did not specify an account, run `node scripts/auth.js accounts` and choose/confirm an explicit email.
6. If auth fails, first run `node scripts/auth.js accounts` to see known profiles.
7. If account mismatch is possible, run `workspace.whoAmI()` in the selected profile.
8. On 401/403/unauthorized errors, switch account (`--email ...`) or re-login that specific profile.

## Unauthorized/account-switch playbook

If a request fails with unauthorized/forbidden/insufficient permissions:

1. Enumerate profiles:

```bash
node scripts/auth.js accounts
```

2. Retry with the intended account:

```bash
node scripts/workspace.js exec --email [email protected] <<'JS'
return await workspace.whoAmI();
JS
```

3. If token is stale or missing scopes, re-login that account:

```bash
node scripts/auth.js login --email [email protected]
```

4. Retry the original request with the same `--email`.

## Short Gmail counting example

```bash
node scripts/workspace.js exec --email [email protected] <<'JS'
const gmail = google.gmail({ version: 'v1', auth });

let trash = 0;
let pageToken;
do {
  const res = await gmail.users.messages.list({
    userId: 'me',
    q: 'in:trash',
    maxResults: 500,
    pageToken,
    fields: 'messages/id,nextPageToken',
  });
  trash += (res.data.messages || []).length;
  pageToken = res.data.nextPageToken;
} while (pageToken);

return { currentlyInTrash: trash };
JS
```

## Setup + auth

```bash
node scripts/auth.js login --email [email protected]
```

Notes:

- Dependencies auto-install on first run.
- Default auth mode is **cloud** (no local `credentials.json` needed).
- Optional local mode: `GOOGLE_WORKSPACE_AUTH_MODE=local` and credentials at `~/.pi/google-workspace/credentials.json`.
- Useful diagnostics:

```bash
node scripts/auth.js accounts
node scripts/auth.js status --email [email protected]
node scripts/auth.js clear --email [email protected]
```

© mitsuhiko · Apache-2.0 · mitsuhiko/agent-stuff

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →

Сначала — google-workspace от других авторов.

google-workspace Nous Research Скилл google-workspace для Claude Code открывает агенту через OAuth и CLI доступ к Gmail, Календарю, Drive, Docs, Sheets и Контактам. Собирает утреннюю сводку и разбирает почту. CX Codex +1 620установок google-workspace membrane Скилл для работы с Google Workspace: управление пользователями, группами, календарями, файлами Drive, почтой и контактами через Membrane CLI. CX Codex +1 274установок google-workspace Agent Skills Team Скилл google-workspace для Claude Code планирует операции Google Workspace и выбирает между Apps Script, REST API и Admin SDK. Работает с файлами, почтой и календарём. CX Codex +1 407установок google-workspace swarmclawai Учит агента работать с Google Workspace через CLI gws: читать и изменять файлы Drive, документы, таблицы, письма, календарь и чаты. CX Codex +1 ★ 710звёзд репо google-workspace-cli Alireza Rezvani Скилл google-workspace-cli для Claude Code управляет Google Workspace через CLI gws: отправляет письма, работает с файлами и таблицами, настраивает календарь. Автоматизирует эти задачи в командах. CX Codex +1 636установок persona-researcher официальный googleworkspace Скилл persona-researcher настраивает роль исследователя для работы с Google Workspace. Он помогает вести заметки в Docs, фиксировать данные в Sheets и рассылать материалы коллегам. CX Codex +1 32 400установок Google Workspace MCP Server conorbronsdon Подключает Gmail, Calendar, Drive и другие сервисы Google Workspace к ИИ-агенту через 67 MCP-инструментов. Подходит для работы с письмами, файлами и задачами. CX Codex +1 ★ 13звёзд репо Workspace Operator Artoxem MCP-сервер Workspace Operator для Claude Code, управляющий сервисами Google через ИИ-агентов. Выполняет пакетные операции в Drive, Sheets, Docs и Gmail с поддержкой отмены действий. CX Codex +1 ★ 12звёзд репо Google Workspace mindstone MCP-сервер Google Workspace предоставляет моделям доступ к почте, документам, файлам и календарю Google. Помогает автоматизировать рутину в рабочих аккаунтах прямо из интерфейса агента. CX Codex +1 ★ 14звёзд репо persona-content-creator официальный googleworkspace Скилл persona-content-creator объединяет процессы Docs, Drive, Gmail, Chat и Slides в один профиль для создания, организации и рассылки контента в Google Workspace. CX Codex +1 31 900установок

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

Весь набор →
librarian Скилл librarian для Claude Code кэширует удалённые Git-репозитории в предсказуемом локальном пути и обновляет их при повторных обращениях. Используется для анализа внешнего кода. CX Codex +1 170установок sentry Скилл подключает ИИ-агента к API Sentry для разбора инцидентов. Помогает находить недавние ошибки, изучать стек вызовов, цепочки breadcrumbs и логи прямо в терминале. CX Codex +1 136установок native-web-search Скилл native-web-search для Claude Code запускает модель с поиском в интернете и возвращает краткую сводку с полными URL источников. Ищет актуальную информацию во время кодирования. CX Codex +1 134установок update-changelog Скилл update-changelog автоматически обновляет CHANGELOG на основе коммитов между последним релизом и текущей версией. CX Codex +1 130установок pi-share Скилл pi-share для Claude Code загружает расшаренные сессии pi и разбирает историю диалога. Анализирует сообщения, вызовы инструментов и действия человека. CX Codex +1 125установок anachb Скилл anachb для Claude и других агентов: находит остановки, показывает ближайшие отправления, строит маршруты и сообщает о сбоях в австрийском общественном транспорте. CX Codex +1 5установок oebb-scotty Скилл oebb-scotty планирует поездки по Австрии через HAFAS-шлюз ÖBB: ищет станции по названию, строит маршруты с пересадками, показывает табло и сообщения о сбоях. CX Codex +1 3установок commit Скилл держит агента в рамках Conventional Commits при git commit и ограничивает стейджинг файлами, которые вы назвали. CX Codex +1 1установок

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

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

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