| name | lark-calendar |
| description | 飞书日历：管理日历日程和会议室。查看/搜索日程、创建/更新日程、管理参会人、查询忙闲和推荐时段、预定会议室。当用户需要查看日程安排、创建/修改会议、查询/预定会议室时使用。不负责：查询过去的视频会议记录（走 lark-vc）、待办任务（走 lark-task）。 |
| zh_description | 用于查询、创建和管理飞书日历事件与日程安排。 |
| version | 1.0.4 |
| author | larksuite |
| source | github:larksuite/cli |
| source_url | https://github.com/larksuite/cli/tree/main/skills/lark-calendar |
| license | MIT |
| tags | [feishu, lark, lark-cli, calendar, scheduling] |
| created_at | 2026-05-19 |
| updated_at | 2026-07-27 |
| quality | 4 |
| complexity | intermediate |
| metadata | {"requires":{"bins":["lark-cli"]},"cliHelp":"lark-cli calendar --help"} |
calendar (v4)
开始前先读 ../lark-shared/SKILL.md（认证、权限处理）。
CRITICAL — 凡涉及预约日程/会议室、调整时间或查询/搜索会议室，第一步 MUST 读 references/lark-calendar-schedule-meeting.md。仅编辑字段（改标题/描述）或增删参会人（不涉及时间和会议室）时可跳过，直接读 references/lark-calendar-update.md。
身份
日程操作默认使用 --as user（查看和管理当前用户的日程）。--as bot 只能访问 bot 自己的（空）日历，会拿到空结果——不要用 bot 身份查用户日程。
lark-cli calendar +agenda --as bot
lark-cli calendar +agenda --as user
Shortcuts
| Shortcut | 说明 |
|---|
+agenda | 查看日程安排（默认今天） |
+meeting | 通过日程事件 ID 获取关联的视频会议信息（meeting_id、meeting_note），日程开过视频会议才会有meeting_id |
+create | 创建日程并邀请参会人（ISO 8601 时间） |
+update | 更新既有日程字段，或独立增量添加/移除参会人和会议室 |
+freebusy | 查询用户主日历的忙闲信息和 RSVP 状态（纯查询场景；预约场景走 +suggestion） |
+room-find | 针对一个或多个明确的时间块查找可用会议室（无明确时间时禁止直接调用，需先走 +suggestion） |
+rsvp | 回复日程（接受/拒绝/待定） |
+suggestion | 根据非明确时间或一段时间范围，推荐多个可用时间块方案 |
+get — 单日程详情
通过 calendar_id + event_id 获取单个日程详情。
lark-cli calendar +get --calendar-id <calendar_id> --event-id <event_id>
读取日程时同时返回 description（纯文本）和 （ 富文本）两个字段： 存纯文本， 存富文本；仅有纯文本描述时， 会用该纯文本兜底填充（两字段值相同）。创建/更新日程时只传 （Markdown）。
