mcpField
G
gccli

gccli

github.com/badlogic生产力2.6k174 次安装21 周前更新
代码仓库

关于 gccli

用于操作 Google Calendar 的命令行工具，可管理日历、活动和可用时间。完成 OAuth 设置后，可列出和查看活动、创建活动并查询忙闲时段。

主要功能

  1. 01列出日历和活动
  2. 02查看活动详情
  3. 03创建日历活动
  4. 04查询忙闲时间
  5. 05配置 OAuth 账号

适用场景

  1. 01查看多个日历中的活动
  2. 02创建日程活动
  3. 03查询指定时段的可用情况

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/badlogic/pi-skills --skill gccli

安装后在 Claude Code 中输入/gccli确认已加载。

详细介绍

Google Calendar CLI

用于执行 Google Calendar 操作的命令行界面。

安装

npm install -g @mariozechner/gccli

设置

Google Cloud Console（一次性设置）
  1. 创建新项目（或选择现有项目）
  2. 启用 Google Calendar API
  3. 在 OAuth 品牌设置中设置应用名称
  4. 添加测试用户（所有要使用的 Gmail 地址）
  5. 创建 OAuth 客户端：
    • 点击“Create Client”
    • 应用类型：“Desktop app”
    • 下载 JSON 文件
配置 gccli

首先检查是否已配置：

gccli accounts list

如果没有账号，请引导用户完成设置：

  1. 询问他们是否有已启用 Calendar API 的 Google Cloud 项目
  2. 如果没有，指导他们完成上述 Google Cloud Console 步骤
  3. 让他们下载 OAuth 凭据 JSON
  4. 运行：gccli accounts credentials ~/path/to/credentials.json
  5. 运行：gccli accounts add <email>（无浏览器 OAuth 请使用 --manual）

用法

运行 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> - 检查空闲时间

主日历的 calendarId 使用 primary。

日期/时间格式

  • 定时活动：YYYY-MM-DDTHH:MM:SSZ（UTC）或 YYYY-MM-DDTHH:MM:SS（本地时间）
  • 全天活动：YYYY-MM-DD，并添加 --all-day 标志

数据存储

  • ~/.gccli/credentials.json - OAuth 客户端凭据
  • ~/.gccli/accounts.json - 账号令牌

评论

支持 Markdown