lark-calendar

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 身份查用户日程。

# BAD — bot 身份查用户日程，返回空列表
lark-cli calendar +agenda --as bot

# GOOD — user 身份查日程
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 获取单个日程详情。

# calendar_id不传，默认primary
lark-cli calendar +get --calendar-id <calendar_id> --event-id <event_id>

读取日程时同时返回 description（纯文本）和 （ 富文本）两个字段： 存纯文本， 存富文本；仅有纯文本描述时， 会用该纯文本兜底填充（两字段值相同）。创建/更新日程时只传 （Markdown）。