一个轻量短小的 Python CLI 工具,用于在命令行管理 Google 日历事件——通过 Calendar API 列出、添加、更新、删除事件。
Google Calendar CLI.是一项面向实际任务的技能,主要用于A 单文件 CLI 仅使用 Python 3 标准库..;Setup. 创建 Google Cloud 项目并启用 Google Calendar API.;
从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。
执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。
一个仅使用 Python 3 标准库的单文件 Google Calendar 命令行工具。
export GOOGLE_CLIENT_ID=... export GOOGLE_CLIENT_SECRET=... export GOOGLE_REFRESH_TOKEN=... export GOOGLE_CALENDAR_ID=primary # 可选,默认为 "primary"
google-calendar-cli.py[options]
| 命令 | 说明 |
|---|---|
list |
列出即将发生的事件 |
today |
显示今日事件 |
add |
创建新事件 |
update |
更新现有事件 |
delete |
删除事件 |
也可通过命令行参数传入凭据(--client-id、--client-secret、--refresh-token、--calendar-id)。
使用 --json 参数可输出原始 JSON 格式;运行时添加 -h 参数可查看完整帮助信息。
# 列出接下来的 10 个事件
python3 {baseDir}/scripts/google-calendar-cli.py list
# 查看今日事件
python3 {baseDir}/scripts/google-calendar-cli.py today
# 查询指定日期范围内的事件
python3 {baseDir}/scripts/google-calendar-cli.py list --from 2025-06-01T00:00:00Z --to 2025-06-30T23:59:59Z
# 添加一个事件
python3 {baseDir}/scripts/google-calendar-cli.py add --title "Meeting"
--start 2025-06-01T09:00:00-07:00 --end 2025-06-01T10:00:00-07:00
# 更新一个事件
python3 {baseDir}/scripts/google-calendar-cli.py update --event-id EVENT_ID --title "New Title"
# 删除一个事件
python3 {baseDir}/scripts/google-calendar-cli.py delete --event-id EVENT_ID