lark-calendar

Manage Lark calendar events, attendees, freebusy queries, and meeting time suggestions via lark-cli.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill lark-calendar-yuezhen-huang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-calendar
Source: https://github.com/yuezhen-huang/my-bytedance-skillhub/tree/main/lark-calendar
Command: npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill lark-calendar-yuezhen-huang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Coordinating meetings in Lark (Feishu) requires checking attendee availability, resolving time conflicts, and creating events with the right participants—tasks that are tedious to do manually through the calendar UI or raw API calls. ## Core Features & Use Cases - Event Scheduling Shortcuts: Use high-level commands like +agenda, +create, +rsvp, +freebusy, and +suggestion to view schedules, create events, reply to invitations, and check availability without memorizing raw API parameters. - Smart Time Recommendations: The +suggestion command returns multiple candidate time slots with reasoning when the meeting time is not yet fixed, including conflict transparency and optimization guidance. - Full Calendar API Access: Manage calendars, events, attendees, and freebusy data through the complete calendar v4 API with documented permission scopes. - Use Case: A user says "schedule a 30-minute sync with Alice and Bob sometime tomorrow afternoon"—the Skill queries freebusy status, proposes several open slots, and creates the event once the user picks one. ## Quick Start Ask the assistant to check your agenda for today and then schedule a 30-minute meeting with a colleague at the next mutually free time this week.

Frequently Asked Questions about lark-calendar

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I schedule a meeting in Lark calendar from the command line?

Use lark-cli calendar +create with --summary, --start, --end in ISO 8601 format, and --attendee-ids listing user (ou_), group (oc_), or room (omm_) IDs. The command automatically sets a 5-minute reminder and busy status, and rolls back the event if adding attendees fails.

How to find a free meeting time for multiple people in Feishu?

Run lark-cli calendar +suggestion with a time range, --attendee-ids, and --duration-minutes. It returns multiple recommended slots with reasoning, and you can exclude previously suggested times using the --exclude parameter to get a fresh batch.

What is the difference between +freebusy and +agenda in lark-cli calendar?

+freebusy returns only busy time blocks and RSVP status from a user's primary calendar, protecting privacy. +agenda returns full event details including titles and descriptions. Use +freebusy for availability checks and +agenda when you need schedule details.

Does lark-cli calendar support recurring events?

Yes, both +create and +suggestion accept an --rrule parameter following the RFC 5545 iCalendar standard, such as FREQ=DAILY;INTERVAL=1. Note that COUNT and UNTIL cannot appear together in the same rule.

Why does my calendar API call fail with permission errors?

Each calendar method requires a specific OAuth scope, such as calendar:calendar.event:create for creating events or calendar:calendar.free_busy:read for freebusy queries. Verify the required scope in the permission table and ensure the app has been granted that scope.

Can I book a meeting room when creating a Lark calendar event?

Rooms can only be added as attendees when a room ID with the omm_ prefix is already available in context; the Skill does not support actively searching and reserving rooms. Pass the omm_ ID via --attendee-ids when creating the event.