Agent Skills
› badlogic/pi-skills
› gccli
gccli
GitHubGoogle Calendar CLI工具,用于列出日历、查看/创建/更新事件及检查可用性。支持OAuth配置与账户管理,提供命令行接口进行日程操作。
触发场景
用户需要查询或管理Google日历事件
用户请求检查特定时间段的空闲状态
安装
npx skills add badlogic/pi-skills --skill gccli -g -y
SKILL.md
Frontmatter
{
"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
npm install -g @mariozechner/gccli
Setup
Google Cloud Console (one-time)
- Create a new project (or select existing)
- Enable the Google Calendar API
- Set app name in OAuth branding
- Add test users (all Gmail addresses you want to use)
- Create OAuth client:
- Click "Create Client"
- Application type: "Desktop app"
- Download the JSON file
Configure gccli
First check if already configured:
gccli accounts list
If no accounts, guide the user through setup:
- Ask if they have a Google Cloud project with Calendar API enabled
- If not, walk them through the Google Cloud Console steps above
- Have them download the OAuth credentials JSON
- Run:
gccli accounts credentials ~/path/to/credentials.json - Run:
gccli accounts add <email>(use--manualfor browserless OAuth)
Usage
Run gccli --help for full command reference.
Common operations:
gccli <email> calendars- List all calendarsgccli <email> events <calendarId> [--from <dt>] [--to <dt>]- List eventsgccli <email> event <calendarId> <eventId>- Get event detailsgccli <email> create <calendarId> --summary <s> --start <dt> --end <dt>- Create eventgccli <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) orYYYY-MM-DDTHH:MM:SS(local) - All-day events:
YYYY-MM-DDwith--all-dayflag
Data Storage
~/.gccli/credentials.json- OAuth client credentials~/.gccli/accounts.json- Account tokens
版本历史
- 90bb51c 当前 2026-07-25 09:42


