飞书日历操作技能
管理飞书日历和日程，包括列出日历、创建/查看/更新/删除日程等。
使用方法
/feishu-calendar list # 列出所有日历
/feishu-calendar list-events <calendar_id> # 列出日历中的日程
/feishu-calendar create-event --calendar-id <id> ... # 创建日程
/feishu-calendar get-event <calendar_id> <event_id> # 获取日程详情
/feishu-calendar update-event <calendar_id> <event_id> # 更新日程
/feishu-calendar delete-event <calendar_id> <event_id> # 删除日程CLI 命令详解
1. 列出日历
feishu-cli calendar list输出示例：
日历列表:
1. 日历ID: CAL_xxx
名称: 我的日历
类型: primary
2. 日历ID: CAL_yyy
名称: 团队日历
类型: shared2. 创建日程
# 基本用法
feishu-cli calendar create-event \
--calendar-id CAL_ID \
--summary "日程标题" \
--start 2024-01-21T14:00:00+08:00 \
--end 2024-01-21T15:00:00+08:00
# 带描述和地点
feishu-cli calendar create-event \
--calendar-id CAL_ID \
--summary "项目评审" \
--start 2024-01-21T14:00:00+08:00 \
--end 2024-01-21T16:00:00+08:00 \
--description "Q1 项目进度评审" \
--location "会议室 A101"
# JSON 格式输出
feishu-cli calendar create-event \
--calendar-id CAL_ID \
--summary "会议" \
--start 2024-01-21T14:00:00+08:00 \
--end 2024-01-21T15:00:00+08:00 \
--output json参数说明：
| 参数 | 简写 | 说明 | 必填 |
|---|---|---|---|
--calendar-id | -c | 日历 ID | 是 |
--summary | -s | 日程标题 | 是 |
--start | 开始时间（RFC3339 格式） | 是 | |
--end | 结束时间（RFC3339 格式） | 是 | |
--description | -d | 日程描述 | 否 |
--location | -l | 地点 | 否 |
--output | -o | 输出格式（json） | 否 |
3. 列出日程
# 列出所有日程
feishu-cli calendar list-events CAL_ID
# 指定时间范围
feishu-cli calendar list-events CAL_ID \
--start-time 2024-01-01T00:00:00+08:00 \
--end-time 2024-01-31T23:59:59+08:00
# 分页查询
feishu-cli calendar list-events CAL_ID --page-size 20
# JSON 格式输出
feishu-cli calendar list-events CAL_ID --output json参数说明：
| 参数 | 说明 | 默认值 |
|---|---|---|
--start-time | 开始时间过滤 | 无 |
--end-time | 结束时间过滤 | 无 |
--page-size | 每页数量 | 50 |
--page-token | 分页标记 | 无 |
--output, -o | 输出格式 | 文本 |
4. 获取日程详情
feishu-cli calendar get-event CAL_ID EVENT_ID5. 更新日程
# 更新标题
feishu-cli calendar update-event CAL_ID EVENT_ID --summary "新标题"
# 更新时间
feishu-cli calendar update-event CAL_ID EVENT_ID \
--start 2024-01-21T15:00:00+08:00 \
--end 2024-01-21T16:00:00+08:00
# 更新多个字段
feishu-cli calendar update-event CAL_ID EVENT_ID \
--summary "更新后的会议" \
--description "会议内容已更新" \
--location "会议室 B202"参数说明：
| 参数 | 简写 | 说明 |
|---|---|---|
--summary | -s | 新的日程标题 |
--start | 新的开始时间 | |
--end | 新的结束时间 | |
--description | -d | 新的日程描述 |
--location | -l | 新的地点 |
--output | -o | 输出格式（json） |
6. 删除日程
feishu-cli calendar delete-event CAL_ID EVENT_ID时间格式说明
使用 RFC3339 格式，示例：
2024-01-21T14:00:00+08:00- 北京时间 14:002024-01-21T06:00:00Z- UTC 时间 06:00
常见时区：
| 时区 | 偏移量 | 示例 |
|---|---|---|
| 北京时间 | +08:00 | 2024-01-21T14:00:00+08:00 |
| UTC | Z | 2024-01-21T06:00:00Z |
| 东京时间 | +09:00 | 2024-01-21T15:00:00+09:00 |
典型工作流
查看今日日程
# 1. 获取日历列表
feishu-cli calendar list
# 2. 查看指定日历今日日程
feishu-cli calendar list-events CAL_ID \
--start-time 2024-01-21T00:00:00+08:00 \
--end-time 2024-01-21T23:59:59+08:00创建会议日程
# 1. 获取日历 ID
feishu-cli calendar list
# 2. 创建日程
feishu-cli calendar create-event \
--calendar-id CAL_xxx \
--summary "周会" \
--start 2024-01-21T10:00:00+08:00 \
--end 2024-01-21T11:00:00+08:00 \
--description "每周团队例会" \
--location "会议室 101"修改日程时间
# 1. 获取日程列表
feishu-cli calendar list-events CAL_ID
# 2. 更新日程时间
feishu-cli calendar update-event CAL_ID EVENT_ID \
--start 2024-01-21T15:00:00+08:00 \
--end 2024-01-21T16:00:00+08:00命令别名
calendar 命令支持别名 cal：
feishu-cli cal list
feishu-cli cal list-events CAL_ID错误处理
| 错误 | 原因 | 解决 |
|---|---|---|
Access denied | 权限不足 | 检查应用是否开通日历权限 |
invalid calendar_id | 日历 ID 无效 | 先用 calendar list 获取有效 ID |
invalid event_id | 日程 ID 无效 | 先用 list-events 获取有效 ID |
invalid time format | 时间格式错误 | 使用 RFC3339 格式（含时区） |
rate limit | API 限流 | 等待几秒后重试 |
注意事项
- 日历 ID：创建日程前需要先通过
calendar list获取日历 ID - 时间格式：必须使用 RFC3339 格式，包含时区信息
- 权限要求：需要应用具有日历相关权限
- 创建日历：当前 CLI 不支持创建新日历，只能使用已有日历创建日程
权限要求（重要）
⚠️ 日历功能需要在飞书开放平台为应用开通以下权限之一：
calendar:calendar:readonly- 只读权限calendar:calendar- 读写权限calendar:calendar.calendar:readonly- 日历只读calendar:calendar:read- 日历读取
申请链接：在飞书开放平台应用后台 → 权限管理 → 申请对应权限
如果遇到 Access denied 错误，请检查应用权限配置。