Calendar Tools

This document details the calendar and event management tools.

⚠️ Important Notes

• Timezone: Asia/Shanghai (UTC+8)
• Time Format: ISO 8601 / RFC 3339, e.g., 2026-02-28T14:00:00+08:00
• user_open_id strongly recommended: Get from SenderId to ensure user can see the event

Tool List

Tool	Function
feishu_calendar_calendar	Manage calendars
feishu_calendar_event	Manage events
feishu_calendar_event_attendee	Manage attendees
feishu_calendar_freebusy	Query free/busy

Usage Examples

Create Meeting

{
  "action": "create",
  "summary": "Project Review Meeting",
  "description": "Discuss Q1 project progress",
  "start_time": "2026-02-28T14:00:00+08:00",
  "end_time": "2026-02-28T15:30:00+08:00",
  "user_open_id": "ou_xxx",
  "attendees": [
    {"type": "user", "id": "ou_yyy"},
    {"type": "user", "id": "ou_zzz"}
  ]
}

Query User Free/Busy

{
  "action": "list",
  "time_min": "2026-02-28T09:00:00+08:00",
  "time_max": "2026-02-28T18:00:00+08:00",
  "user_ids": ["ou_xxx", "ou_yyy"]
}

Update Event Time

{
  "action": "patch",
  "event_id": "xxx_0",
  "start_time": "2026-02-28T15:00:00+08:00",
  "end_time": "2026-02-28T16:00:00+08:00"
}

Attendee Permissions

Value	Description
none	No permission
can_see_others	Can see attendee list
can_invite_others	Can invite others
can_modify_event	Can edit event (recommended)

ID Types

Type	Format	Description
User	ou_xxx	User open_id
Group	oc_xxx	Group chat ID
Room	omm_xxx	Meeting room ID
Email	user@domain.com	Third-party email