lark-attendance
larksuite/cli
Query your Lark attendance clock-in records.
What is lark-attendance?
This skill lets you retrieve your own attendance and clock-in records from Lark (飞书). Use it when you need to check your attendance history, verify punch times, or audit your work hours.
- Query personal attendance clock-in records
- Automatically populate required parameters (employee_type and user_ids)
- Access attendance data via Lark CLI API
- View attendance task information and history
How to install lark-attendance
npx skills add null --skill lark-attendance- lark-cli installed and configured
- Valid Lark authentication (see lark-shared skill)
- attendance:task:readonly permission scope
How to use lark-attendance
- 1.Install the skill using: npx skills add null --skill lark-attendance
- 2.Ensure you have read the lark-shared/SKILL.md for authentication setup
- 3.Run `lark-cli schema attendance.user_tasks.query` to view available parameters
- 4.Call `lark-cli attendance user_tasks query` with your desired filters (date range, etc.)
- 5.Review the returned attendance records
Use cases
- Check your own attendance records for a specific date range
- Verify clock-in and clock-out times
- Review attendance history for payroll or compliance purposes
- Audit personal work hour records
- Employees using Lark for attendance tracking
- HR personnel managing their own attendance records
- Anyone needing to verify their clock-in history
lark-attendance FAQ
No. These parameters are automatically filled: user_ids is always an empty array and employee_type is always 'employee_no'. You should not provide them.
You need the attendance:task:readonly scope in your Lark authentication.
This skill queries only your own attendance records. The user_ids parameter is fixed to an empty array, which retrieves your personal data.
Run `lark-cli schema attendance.user_tasks.query` before making API calls to see the exact --data and --params format.
Full instructions (SKILL.md)
Source of truth, from larksuite/cli.
name: lark-attendance version: 1.0.0 description: "飞书考勤打卡：查询自己的考勤打卡记录" metadata: requires: bins: ["lark-cli"] cliHelp: "lark-cli attendance --help"
attendance (v1)
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md，其中包含认证、权限处理
默认参数自动填充规则
调用任何 API 时，以下参数 必须自动填充，禁止向用户询问：
| 参数 | 固定值 | 说明 |
|---|---|---|
employee_type | "employee_no" | employee_type始终等于"employee_no" |
user_ids | []（空数组） | user_ids始终等于[] |
填充示例
当构建 --params 参数时，自动注入上述字段：
employee_type保持"employee_no"不变
当构建 --data 参数时，自动注入上述字段：
{
"user_ids": [],
...用户提供的参数
}
注意：
user_ids数组保持为空[]，employee_type保持"employee_no"不变。
API Resources
lark-cli schema attendance.<resource>.<method> # 调用 API 前必须先查看参数结构
lark-cli attendance <resource> <method> [flags] # 调用 API
重要：使用原生 API 时，必须先运行
schema查看--data/--params参数结构，不要猜测字段格式。
user_tasks
query— 查询用户考勤打卡记录
权限表
| 方法 | 所需 scope |
|---|---|
user_tasks.query | attendance:task:readonly |
Related skills
More from larksuite/cli and the wider catalog.
lark-doc
Read and edit Lark/Feishu Docx & Wiki documents via CLI — fetch, create, update, and manage media attachments.
lark-base
Manage Lark Base (multi-dimensional tables): create tables, fields, records, views, formulas, forms, dashboards, workflows, and roles.
lark-im
Lark/Feishu IM skill: send messages, manage group chats, download files, and handle interactive cards via lark-cli
lark-drive
Manage Lark/Feishu Drive files and folders: upload, download, import, organize, comment, and control permissions.
lark-shared
Manage Lark CLI auth, identity, permissions, and scopes for coding agents like Claude Code and Cursor
lark-calendar
Manage Lark calendar events and meeting rooms: view, create, update events, check availability, and book rooms.