用途：gccli 是面向 Google Calendar 的命令行界面，用于在终端中管理日历与事件，适合脚本化、自动化处理日程的场景。
主要能力：列出账号下的所有日历；按时间范围列出事件；查看单个事件详情；创建事件；检查多个日历的空闲/忙碌状态。主日历可用 primary 作为 calendarId。
安装：npm install -g @mariozechner/gccli
配置：需在 Google Cloud Console 创建项目、启用 Google Calendar API、设置 OAuth 品牌应用名、添加测试用户（要使用的 Gmail 地址）、创建“桌面应用”类型 OAuth 客户端并下载 JSON。随后执行 gccli accounts credentials ~/path/to/credentials.json 导入凭据，再执行 gccli accounts add <email> 添加账号，无浏览器环境可用 --manual 参数完成 OAuth。可先用 gccli accounts list 检查是否已配置。
常用命令：gccli --help 查看完整参考；gccli <email> calendars 列出日历；gccli <email> events <calendarId> [--from <dt>] [--to <dt>] 列出事件；gccli <email> event <calendarId> <eventId> 查看事件详情；gccli <email> create <calendarId> --summary <s> --start <dt> --end <dt> 创建事件；gccli <email> freebusy <calendarIds> --from <dt> --to <dt> 检查空闲。
时间格式：定时事件用 YYYY-MM-DDTHH:MM:SSZ（UTC）或 YYYY-MM-DDTHH:MM:SS（本地）；全天事件用 YYYY-MM-DD 并加 --all-day 标志。
数据存储：OAuth 客户端凭据存于 ~/.gccli/credentials.json，账号令牌存于 ~/.gccli/accounts.json。
限制：需自行准备 Google Cloud 项目并启用 Calendar API，配置过程涉及 OAuth 授权；资料未提供具体限额、平台差异及价格信息。