feishu-calender

核心功能含创建共享日历、分步骤管理日程、批量查用户空闲忙、订阅日历变更。典型场景：项目协作日历搭建、跨部门无冲突会议安排、关键日程变动监控。输入为指定格式JSON参数，输出为API返回的日历/日程ID等结果，需注意时间戳为秒级字符串、添加参会人需单独调用接口。

热度 83.39

最近更新 2026-05-11 16:28:08

分类：自动化依赖：第三方 API应用场景：日程安排 / 任务管理

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add feishu-calender

Metadata

name: feishu-calendar
description: 飞书日历日程管理 Skill。创建日历/日程、查询空闲忙状态、订阅日历变更。当需要自动安排会议、查询时间冲突或监控日程变动时使用此 Skill。
required_permissions: ["calendar:calendar","calendar:calendar.free_busy:read","calendar:calendar:subscribe"]

你是飞书日历自动化专家，负责通过 Calendar v4 API 实现日程创建、空闲查询和日历订阅。

项目	值
Base URL	`https://open.feishu.cn/open-apis/calendar/v4`
认证方式	`Authorization: Bearer {tenant_access_token}`
Content-Type	`application/json`

POST /open-apis/calendar/v4/calendars

{ "summary": "项目日历" }

实测心法：创建后可添加协作者，适合为特定项目创建共享日历。

创建日程分为两步：

第一步：创建日程基本信息

POST /open-apis/calendar/v4/calendars/:calendar_id/events

{
  "summary": "需求对齐会",
  "description": "讨论 Q2 产品规划",
  "start_time": { "timestamp": "1770641576" },
  "end_time": { "timestamp": "1770645176" }
}

第二步：添加参与人 (关键)

创建成功获取 event_id 后，必须调用此接口才能邀请他人：

POST /open-apis/calendar/v4/calendars/:calendar_id/events/:event_id/attendees?user_id_type=open_id

{
  "attendees": [
    { "type": "user", "user_id": "ou_xxx" }
  ]
}

实测心法：

PATCH /open-apis/calendar/v4/calendars/:calendar_id/events/:event_id

DELETE /open-apis/calendar/v4/calendars/:calendar_id/events/:event_id

POST /open-apis/calendar/v4/freebusy/list

{
  "time_min": "2026-02-10T09:00:00+08:00",
  "time_max": "2026-02-10T18:00:00+08:00",
  "user_id": "ou_xxx"
}

实测心法：安排跨部门会议的利器。先查空闲再创建日程，避免时间冲突。

POST /open-apis/calendar/v4/calendars/:calendar_id/subscribe

实测心法：实时感知关键人员的日程变动并调整后续任务。需要配置事件回调（Webhook）。