古法编程

如何使用 AI 自动化管理 Google 日历行程

解决手动操作日历繁琐的问题：通过一套轻量级的 Python 脚本工具，让 AI 能够直接调用 Google Calendar API 来创建会议、检索日程以及自动寻找参与者的空闲时间。

为什么需要这个技能

在处理复杂的日程安排时，手动在网页端切换、对比多个参与者的空闲时间并创建会议非常低效。

本技能提供了一套独立的 OAuth 认证机制，无需搭建复杂的 MCP（Model Context Protocol）服务器即可实现对 Google 日历的精细化操作。它支持通过命令行快速完成日程的增删改查，使 AI 能够直接将自然语言指令转化为具体的日历操作，极大地提升了办公自动化效率。

⚠️ 注意：本技能仅支持 Google Workspace 企业/组织账号，不支持个人 Gmail 账号。

适用场景

  • 需要通过本地脚本或 AI 助手快速列出、创建或更新 Google 日历事件。
  • 在 Workspace 环境中需要自动化处理会议邀请、管理参与者名单。
  • 需要快速检索多个参与者在特定时间段内的共同空闲时间（Free Time）。
  • 希望在不部署重型服务器的情况下实现安全的 OAuth 授权访问。

核心工作流

1. 身份认证

首次使用需要通过浏览器完成 Google 授权：

python scripts/auth.py login

可以通过 python scripts/auth.py status 检查认证状态，或使用 logout 退出。

2. 日程管理操作

所有功能均通过 scripts/gcal.py 实现，主要命令如下：

  • 查询日程：

    # 列出未来 30 天事件
python scripts/gcal.py list-events
# 指定时间范围查询
python scripts/gcal.py list-events --time-min 2024-01-15T00:00:00Z --time-max 2024-01-31T23:59:59Z

  • 创建与更新：

    # 创建基础会议
python scripts/gcal.py create-event "Team Meeting" "2024-01-15T10:00:00Z" "2024-01-15T11:00:00Z"
# 更新会议标题
python scripts/gcal.py update-event EVENT_ID --summary "New Title"

  • 智能检索空闲时间：

    # 为自己和他人寻找 60 分钟的空闲时段
python scripts/gcal.py find-free-time \
    --attendees me user1@example.com user2@example.com \
    --time-min "2024-01-15T09:00:00Z" \
    --time-max "2024-01-19T17:00:00Z" \
    --duration 60

3. 数据规范

  • 时间格式：必须使用 ISO 8601 格式（如 2024-01-15T10:30:00Z）。
  • 令牌管理：Token 将安全地存储在系统密钥环中（macOS Keychain / Windows Credential Locker）。

下载和安装

下载 google-calendar-automation 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹，重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。

你可能还需要

暂无推荐