View your daily agenda, create events with attendees, query free/busy status across team members, and get AI-powered optimal meeting time suggestions.
The Feishu CLI calendar module provides 4 shortcut commands for complete calendar management. View your daily agenda, create events with attendees, query free/busy status across team members, and get AI-powered optimal meeting time suggestions. These shortcuts wrap the Lark Open Platform Calendar API and support both user and bot identities.
Display your upcoming events for today or a custom date range. By default, +agenda shows today’s events. The output includes event title, time, attendees, and status.
| Parameter | Description |
|---|---|
--start | Start date or datetime (defaults to today) |
--end | End date or datetime (defaults to end of today) |
--calendar-id | Target calendar ID (defaults to primary) |
Each event in the output includes: event title, start/end time, attendees (names and response status), location, and organizer. All-day events are shown separately from timed events.
Create events with a summary, time range, attendees, description, and recurrence rules. The --start and --end parameters are required.
| Parameter | Description | Required |
|---|---|---|
--summary | Event title | Yes |
--start | Start date or datetime (ISO 8601) | Yes |
--end | End date or datetime (ISO 8601) | Yes |
--attendee-ids | Comma-separated user IDs to invite | No |
--description | Event description or notes | No |
--rrule | iCalendar recurrence rule (RFC 5545) | No |
Query the free/busy status of one or more users for a given time range. Essential for finding available slots before scheduling meetings.
| Parameter | Description |
|---|---|
--user-id | User ID to check availability for |
--start | Start of the time range |
--end | End of the time range |
The output shows busy time blocks within the queried range, making it easy to identify open slots for scheduling.
Get intelligent meeting time suggestions based on attendee calendars. The AI analyzes availability across all participants and recommends optimal slots.
This shortcut leverages Feishu’s AI scheduling engine to recommend times when all attendees are available, accounting for timezone differences and working hours preferences.
Beyond shortcuts, you can access the full Calendar API directly for advanced use cases. These commands map directly to the Lark Open Platform Calendar API endpoints.
Use lark-cli schema to explore the full parameter set for any API endpoint before calling it directly.
Calendar commands require specific OAuth scopes depending on the operation. Both user and bot identities are supported for most commands.
| Operation | Required Scope | Identity |
|---|---|---|
| View agenda / list events | calendar:calendar:readonly | User, Bot |
| Create events | calendar:calendar | User, Bot |
| Check free/busy | calendar:calendar:readonly | User, Bot |
| Time suggestions | calendar:calendar:readonly | User |
Ensure your app has the required scopes enabled in the Lark Open Platform developer console before using these commands.
When scheduling across time zones, combine +freebusy with +suggestion to find slots that work for distributed teams. Feishu CLI handles timezone conversion automatically based on each user’s configured timezone.
Combine calendar data with messaging to generate automated daily standup summaries. Use +agenda to pull today’s events, then pipe the output to the messaging module to post in your team channel.
Use the lower-level API to query meeting room calendars and create bookings. Meeting rooms are represented as calendar resources in the Lark platform.
| Shortcut | Description | Risk | Key Parameters |
|---|---|---|---|
+agenda | View calendar agenda for a date range | Safe | --start, --end, --calendar-id |
+create | Create a new calendar event | Medium | --summary, --start, --end, --attendee-ids, --rrule |
+freebusy | Query free/busy status | Safe | --user-id, --start, --end |
+suggestion | AI-powered meeting time suggestions | Safe | (interactive) |