name: google-calendar description: 查看、创建、更新和删除日历事件

Google 日历

可用工具

list_calendars(): 列出所有用户的日历（主要、共享、订阅）。
list_events(calendar_id?, max_results?, time_min?, time_max?, query?, show_deleted?): 列出日历事件。
- calendar_id (字符串, 可选, 默认: “primary”): 日历ID
- max_results (整数, 可选, 默认: 10, 最大: 100): 最大事件数
- time_min (字符串, 可选, 默认: now): 开始时间，RFC3339格式（例如：“2024-01-01T00:00:00Z”）
- time_max (字符串, 可选): 结束时间，RFC3339格式
- query (字符串, 可选): 自由文本搜索
- show_deleted (布尔值, 可选, 默认: false): 包括已删除事件
get_event(event_id, calendar_id?): 获取特定事件的详细信息。
- event_id (字符串, 必需): 事件ID（来自list_events）
- calendar_id (字符串, 可选, 默认: “primary”)
create_event(summary, start_time, end_time, calendar_id?, description?, location?, attendees?, timezone?, all_day?, reminder_minutes?): 创建新事件。
- summary (字符串, 必需): 事件标题
- start_time (字符串, 必需): RFC3339格式（例如：“2024-01-15T09:00:00”）或日期 “YYYY-MM-DD” 用于全天事件
- end_time (字符串, 必需): RFC3339格式或日期用于全天事件
- calendar_id (字符串, 可选, 默认: “primary”)
- description (字符串, 可选): 事件描述/备注
- location (字符串, 可选): 事件地点
- attendees (字符串, 可选): 逗号分隔的电子邮件地址
- timezone (字符串, 可选, 默认: “UTC”): 时区（例如：“Asia/Seoul”, “America/New_York”）
- all_day (布尔值, 可选, 默认: false): 创建全天事件（使用 YYYY-MM-DD 作为时间）
- reminder_minutes (字符串, 可选): 逗号分隔的提醒时间，以分钟为单位（例如：“10,30,60”）
update_event(event_id, calendar_id?, summary?, start_time?, end_time?, description?, location?, attendees?, timezone?): 更新现有事件。仅更改指定的字段。
- event_id (字符串, 必需)
- calendar_id (字符串, 可选, 默认: “primary”)
- 其他参数可选 — 只提供要更改的字段
delete_event(event_id, calendar_id?, send_notifications?): 删除事件。
- event_id (字符串, 必需)
- calendar_id (字符串, 可选, 默认: “primary”)
- send_notifications (布尔值, 可选, 默认: false): 向参与者发送取消通知
quick_add_event(text, calendar_id?): 从自然语言文本创建事件。
- text (字符串, 必需): 自然语言描述（例如：“明天下午3点与John开会”，“每周一上午9点团队站立会议”）
- calendar_id (字符串, 可选, 默认: “primary”)
check_availability(time_min, time_max, calendars?, timezone?): 检查空闲/忙碌状态。
- time_min (字符串, 必需): 范围开始时间，RFC3339格式
- time_max (字符串, 必需): 范围结束时间，RFC3339格式
- calendars (字符串, 可选): 逗号分隔的日历ID（默认: primary）
- timezone (字符串, 可选, 默认: “UTC”)

使用指南

时间格式: RFC3339 — 2024-01-15T09:00:00Z (UTC) 或 2024-01-15T09:00:00+09:00 (带时区)。
全天事件: 使用日期格式 YYYY-MM-DD 并设置 all_day=true。
默认日历为 "primary"。

常见操作

安排会议: 使用 create_event 并指定 attendees 参数，以完全控制时间、描述和提醒。

查找可用时间: 在创建事件之前调用 check_availability 并指定相关日历ID和时间范围，以避免冲突。

快速安排: quick_add_event 接受自然语言（例如：“明天中午与Sarah午餐”）。方便但不如 create_event 精确。

重新安排: 使用 update_event 并指定新的 start_time 和 end_time。只更改您提供的字段。