飞书日历操作技能

管理飞书日历和日程，包括列出日历、创建/查看/更新/删除日程等。

使用方法

/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 名称: 团队日历 类型: shared

3. 创建日程

基本用法

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_ID

5. 更新日程

更新标题

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:00

• 2024-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 错误，请检查应用权限配置。