用途：为 AI 智能体提供 Google 日历的完整增删改查管理能力，可列出、创建、更新、删除、搜索事件，并管理多个日历。
主要能力：list 查看即将到来的事件，支持时间范围与文本过滤；get 按 ID 获取单个事件完整详情；search 对事件做自由文本搜索；create 创建事件，支持参与者、地点、时区与全天事件；update 以 patch 语义更新事件，仅修改所提供的字段；delete 删除事件；quick 用自然语言快速创建事件；calendars 列出所有可用日历。
前置条件：需启用 Google Calendar API 的 Google Cloud 项目，以及 OAuth 2.0 凭据，可选 gcloud ADC 或 credentials.json。快速安装可一次配置 Gmail、Calendar 和 Contacts：uv run ~/.agents/skills/gmail/scripts/setup_workspace.py。手动使用 gcloud ADC：gcloud auth application-default login --scopes https://www.googleapis.com/auth/calendar,https://www.googleapis.com/auth/cloud-platform，随后运行 uv run skills/google-calendar/scripts/google_calendar.py verify 验证。替代方式：将 credentials.json 放入 ~/.calendar_credentials/，再运行 uv run skills/google-calendar/scripts/google_calendar.py setup。
使用方式示例：列出最近 5 个事件用 uv run skills/google-calendar/scripts/google_calendar.py list --limit 5；按时间范围用 list --after --before；按文本用 list --query；获取单个事件用 get --id；搜索用 search --query --limit；创建定时事件用 create --summary --start --end --description --location --attendees，全天事件加 --all-day；更新用 update --id 加需改字段；删除用 delete --id；自然语言快速添加用 quick --text；列出日历用 calendars。事件以 JSON 输出，含 id、summary、description、location、start、end、status、attendees、htmlLink 等字段。
适用场景：智能体代为安排会议、查询日程、批量管理与检索日历事件。限制：必须预先完成 Google Cloud 与 OAuth 配置；时区、全天事件等行为依赖参数正确传入；资料未提供收费、价格与具体平台支持范围等信息。