google-workspace · mitsuhiko — скилл для Claude Code: доступ к Google API
Скилл даёт агенту доступ к Google Workspace (Gmail, Drive, Docs, Calendar, Sheets и другим) через локальные скрипты. Подходит, если вам нужно автоматизировать работу с гугловскими сервисами прямо из IDE.
Apache-2.0 108 установок ★ 3 224 обновлён 2026-09-27
npx skills add mitsuhiko/agent-stuff --skill google-workspace -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/google-workspace/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/google-workspace/
1Через Skills CLI (Vercel)
npx skills add mitsuhiko/agent-stuff --skill google-workspace -a codex2Вручную: положить файлы
.agents/skills/google-workspace/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add mitsuhiko/agent-stuff --skill google-workspace -a cursor2Вручную: положить файлы
.cursor/skills/google-workspace/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install mitsuhiko/agent-stuff skills/google-workspace2Вручную: положить файлы
.github/skills/google-workspace/SKILL.md1Через Skills CLI (Vercel)
npx skills add mitsuhiko/agent-stuff --skill google-workspace -a gemini-cli2Командой платформы
gemini skills install https://github.com/mitsuhiko/agent-stuff --path skills/google-workspaceВручную: положить файлы
.devin/skills/google-workspace/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add mitsuhiko/agent-stuff --skill google-workspace -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.