gccli — скилл для Claude Code: работа с Google Calendar из агента
Скилл gccli для Claude Code обучает ИИ-агента управлять Google Calendar через консольную утилиту. Агент просматривает календари, создаёт и меняет события, проверяет свободные окна.
MIT 177 установок ★ 2 663 обновлён 2026-06-06
npx skills add badlogic/pi-skills --skill gccli -a claude-codeЧто делает gccli
gccli подключает к агенту консольный клиент Google Calendar. Агент получает инструкцию по командам и может смотреть списки календарей, создавать события, менять их и проверять свободные окна.
Сам клиент ставится через npm: npm install -g @mariozechner/gccli. Для работы нужен проект в Google Cloud Console с включённым Calendar API и OAuth-клиент типа Desktop app. Учётные записи хранятся в ~/.gccli/.
Без OAuth-настройки ничего не заработает. В Google Cloud Console нужно создать проект, включить API, добавить тестовых пользователей и скачать credentials.json — это отдельная процедура до установки скилла.
Какие задачи решает
- посмотреть список календарей конкретного аккаунта
- создать событие с указанием времени начала и конца
- проверить занятость по нескольким календарям
- найти свободный слот через freebusy
- получить детали конкретного события по ID
Примеры запросов агенту
- Покажи мои календари с
gccliдля почты[email protected] - Создай встречу в основном календаре на завтра с 14:00 до 15:00
- Проверь, свободен ли я в пятницу с 10:00 до 12:00
Как установить gccli
1Через Skills CLI (Vercel)
npx skills add badlogic/pi-skills --skill gccli -a claude-code2Вручную: положить файлы
~/.claude/skills/gccli/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/gccli/
1Через Skills CLI (Vercel)
npx skills add badlogic/pi-skills --skill gccli -a codex2Вручную: положить файлы
.agents/skills/gccli/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add badlogic/pi-skills --skill gccli -a cursor2Вручную: положить файлы
.cursor/skills/gccli/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install badlogic/pi-skills gccli2Вручную: положить файлы
.github/skills/gccli/SKILL.md1Через Skills CLI (Vercel)
npx skills add badlogic/pi-skills --skill gccli -a gemini-cli2Командой платформы
gemini skills install https://github.com/badlogic/pi-skills --path gccliВручную: положить файлы
.devin/skills/gccli/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add badlogic/pi-skills --skill gccli -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о gccli
Как установить gccli в Claude Code?
Выполните npx skills add badlogic/pi-skills --skill gccli -a claude-code. Скилл появится в ~/.claude/skills/gccli/SKILL.md.
Что нужно для работы gccli?
Сначала установите сам клиент через npm install -g @mariozechner/gccli. Потом настройте OAuth в Google Cloud Console: включите Calendar API, создайте Desktop app клиент и добавьте тестовых пользователей.
Как добавить аккаунт Google?
Загрузите credentials.json через gccli accounts credentials ~/path/to/credentials.json, затем выполните gccli accounts add <email>. Для окружений без браузера есть флаг --manual.
Исходный текст
SKILL.md · MIT
--- name: gccli description: Google Calendar CLI for listing calendars, viewing/creating/updating events, and checking availability. --- # Google Calendar CLI Command-line interface for Google Calendar operations. ## Installation ```bash npm install -g @mariozechner/gccli ``` ## Setup ### Google Cloud Console (one-time) 1. [Create a new project](https://console.cloud.google.com/projectcreate) (or select existing) 2. [Enable the Google Calendar API](https://console.cloud.google.com/apis/api/calendar-json.googleapis.com) 3. [Set app name](https://console.cloud.google.com/auth/branding) in OAuth branding 4. [Add test users](https://console.cloud.google.com/auth/audience) (all Gmail addresses you want to use) 5. [Create OAuth client](https://console.cloud.google.com/auth/clients): - Click "Create Client" - Application type: "Desktop app" - Download the JSON file ### Configure gccli First check if already configured: ```bash gccli accounts list ``` If no accounts, guide the user through setup: 1. Ask if they have a Google Cloud project with Calendar API enabled 2. If not, walk them through the Google Cloud Console steps above 3. Have them download the OAuth credentials JSON 4. Run: `gccli accounts credentials ~/path/to/credentials.json` 5. Run: `gccli accounts add <email>` (use `--manual` for browserless OAuth) ## Usage Run `gccli --help` for full command reference. Common operations: - `gccli <email> calendars` - List all calendars - `gccli <email> events <calendarId> [--from <dt>] [--to <dt>]` - List events - `gccli <email> event <calendarId> <eventId>` - Get event details - `gccli <email> create <calendarId> --summary <s> --start <dt> --end <dt>` - Create event - `gccli <email> freebusy <calendarIds> --from <dt> --to <dt>` - Check availability Use `primary` as calendarId for the main calendar. ## Date/Time Format - Timed events: `YYYY-MM-DDTHH:MM:SSZ` (UTC) or `YYYY-MM-DDTHH:MM:SS` (local) - All-day events: `YYYY-MM-DD` with `--all-day` flag ## Data Storage - `~/.gccli/credentials.json` - OAuth client credentials - `~/.gccli/accounts.json` - Account tokens
© badlogic · MIT · badlogic/pi-skills