# Feishu Calendar

> When 飞书日历 events or meetings need managing → CRUD calendar events, manage attendees, query free/busy status.

- Skill: `cklxx/feishu-calendar` (Agent Skill)
- Install (CLI): `npx skillmds@latest add cklxx/feishu-calendar`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cklxx/feishu-calendar/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: cklxx (https://skillmd.com/u/cklxx)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/cklxx/feishu-calendar

---


# Feishu Calendar Skill

## 快速索引

| 用户意图 | module | tool_action | 必填参数 |
|---------|--------|-------------|---------|
| 创建日程 | calendar | create | title, start, duration |
| 查询日程 | calendar | query | start, end |
| 更新日程 | calendar | update | event_id + 要更新的字段 |
| 删除日程 | calendar | delete | event_id |
| 列出日历 | calendar | list_calendars | - |
| 查忙闲 | calendar | freebusy | user_ids, start, end |

## 调用示例

### 创建日程

```bash
python3 skills/feishu-cli/run.py '{
  "action": "tool",
  "module": "calendar",
  "tool_action": "create",
  "title": "周会",
  "start": "2026-03-10 10:00",
  "duration": "60m",
  "attendees": ["ou_xxx", "ou_yyy"],
  "description": "每周同步进度"
}'
```

### 查询日程

```bash
python3 skills/feishu-cli/run.py '{
  "action": "tool",
  "module": "calendar",
  "tool_action": "query",
  "start": "2026-03-10",
  "end": "2026-03-14"
}'
```

### 查忙闲

```bash
python3 skills/feishu-cli/run.py '{
  "action": "tool",
  "module": "calendar",
  "tool_action": "freebusy",
  "user_ids": ["ou_xxx", "ou_yyy"],
  "start": "2026-03-10 09:00",
  "end": "2026-03-10 18:00"
}'
```

## 核心约束

- **时间格式**：支持 `"2026-03-10 10:00"` 或 ISO 8601 `"2026-03-10T10:00:00+08:00"`
- **duration**: 支持 `"30m"`, `"1h"`, `"1h30m"` 等格式
- **attendees**: 使用 `open_id`（`ou_` 开头），数组格式
- **时区**: 默认使用服务器时区，可通过 `timezone` 参数指定（如 `"Asia/Shanghai"`）
- **日历 ID**: 大部分操作默认使用主日历，可通过 `calendar_id` 指定其他日历
- **重复日程**: 使用 `recurrence` 参数（RRULE 格式），如 `"FREQ=WEEKLY;BYDAY=MO"`

## 常见错误

| 错误 | 原因 | 解决 |
|------|------|------|
| 无权限访问日历 | 未授权 calendar 相关 scope | 执行 OAuth 授权 |
| 参会人无法添加 | user_id 格式错误 | 确认使用 open_id（ou_开头） |
| 时间冲突 | 目标时间段已有日程 | 先查询忙闲确认空闲 |