feishu-calendar

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Feishu Calendar

Feishu 日历

Manage your Feishu calendar with automatic user authorization. Create, update, delete, and query calendar events.

通过自动用户授权管理你的Feishu日历。支持创建、更新、删除和查询日历事件。

Quick Start

快速开始

Create an Event

创建事件

bash

bash scripts/create_event.sh "Event Title" "2026-02-01 10:00:00" "2026-02-01 11:00:00" "Description"

Returns event ID and link.

bash

bash scripts/create_event.sh "Event Title" "2026-02-01 10:00:00" "2026-02-01 11:00:00" "Description"

返回事件ID和链接。

List Today's Events

列出今日事件

bash

bash scripts/list_events.sh

bash

bash scripts/list_events.sh

Get Event Details

获取事件详情

bash

bash scripts/get_event.sh <event_id>

bash

bash scripts/get_event.sh <event_id>

Update an Event

更新事件

bash

bash scripts/update_event.sh <event_id> "New Title" "2026-02-01 14:00:00" "2026-02-01 15:00:00"

bash

bash scripts/update_event.sh <event_id> "New Title" "2026-02-01 14:00:00" "2026-02-01 15:00:00"

Delete an Event

删除事件

bash

bash scripts/delete_event.sh <event_id>

bash

bash scripts/delete_event.sh <event_id>

Setup

设置步骤

Prerequisites

前提条件

User must authorize with Feishu OAuth (one-time)
Credentials stored at
```
~/.feishu-credentials.json
```

Required permissions:

calendar:calendar calendar:event offline_access

用户需通过Feishu OAuth完成一次性授权
凭据存储在
```
~/.feishu-credentials.json
```

所需权限：

calendar:calendar calendar:event offline_access

Verify Setup

验证设置

bash

bash scripts/verify_setup.sh

bash

bash scripts/verify_setup.sh

Scripts

脚本说明

Script	Purpose
`create_event.sh`	Create a new calendar event
`list_events.sh`	List events (today or date range)
`get_event.sh`	Get event details
`update_event.sh`	Update event title/time
`delete_event.sh`	Delete an event
`verify_setup.sh`	Check credentials and permissions

脚本	用途
`create_event.sh`	创建新的日历事件
`list_events.sh`	列出事件（今日或指定日期范围）
`get_event.sh`	获取事件详情
`update_event.sh`	更新事件标题/时间
`delete_event.sh`	删除事件
`verify_setup.sh`	检查凭据和权限

Important Notes

重要说明

Event Ownership

事件归属

Events are created in your personal calendar
You own all events created through this Skill
Automatic token refresh keeps events accessible long-term
Your identity:
```
ou_1f553aa193ea382ef8239c16dee55fed
```

创建的事件会保存在你的个人日历中
通过此Skill创建的所有事件都归你所有
自动令牌刷新可确保长期访问事件
你的身份标识：
```
ou_1f553aa193ea382ef8239c16dee55fed
```

DateTime Format

日期时间格式

All scripts use ISO 8601 format with time zone support:

Format:
```
YYYY-MM-DD HH:MM:SS
```
(assumes your local time)
Example:
```
2026-02-01 14:30:00
```

所有脚本均支持带时区的ISO 8601格式：

格式：
```
YYYY-MM-DD HH:MM:SS
```
（默认使用本地时间）
示例：
```
2026-02-01 14:30:00
```

Event IDs

事件ID

Event IDs are used for updates and deletions
Returned when creating events
Can also be retrieved via
```
list_events.sh
```

事件ID用于更新和删除操作
创建事件时会返回事件ID
也可通过
```
list_events.sh
```
检索事件ID

Examples

示例

Create a meeting

创建会议

bash

bash scripts/create_event.sh \
  "Team Sync" \
  "2026-02-01 10:00:00" \
  "2026-02-01 11:00:00" \
  "Weekly team synchronization meeting"

bash

bash scripts/create_event.sh \
  "Team Sync" \
  "2026-02-01 10:00:00" \
  "2026-02-01 11:00:00" \
  "Weekly team synchronization meeting"

List all events this week

列出本周所有事件

bash

bash scripts/list_events.sh "2026-01-31" "2026-02-07"

bash

bash scripts/list_events.sh "2026-01-31" "2026-02-07"

Update an event

更新事件

bash

bash scripts/update_event.sh "event_id_here" \
  "Updated Title" \
  "2026-02-02 15:00:00" \
  "2026-02-02 16:00:00"

bash

bash scripts/update_event.sh "event_id_here" \
  "Updated Title" \
  "2026-02-02 15:00:00" \
  "2026-02-02 16:00:00"

Troubleshooting

故障排除

"Permission denied" error

“权限被拒绝”错误

Run

verify_setup.sh

to check credentials and permissions.

运行

verify_setup.sh

检查凭据和权限。

Event not found

事件未找到

Verify the event ID is correct. Use

list_events.sh

to find event IDs.

确认事件ID正确。可使用

list_events.sh

查找事件ID。

Token errors

令牌错误

The Skill automatically refreshes tokens. If you see authorization errors, re-authorize through the OAuth flow.

此Skill会自动刷新令牌。若遇到授权错误，请重新通过OAuth流程进行授权。

References

参考资料

Feishu Calendar API Documentation
Event Management - Event creation, update, and deletion details

Feishu 日历API文档
事件管理 - 事件创建、更新和删除的详细说明