feishu-cli-vc

Original：🇨🇳 Chinese
Translated

Feishu video conferencing and Minutes operation guide. It supports searching historical meeting records, obtaining meeting minutes and verbatim transcripts, and viewing Minutes information. It is used when users request "search meetings", "meeting records", "meeting minutes", "verbatim transcript", "Minutes", "meeting", "vc search", "minutes", "view recent meetings". It is also applicable to scenarios where users want to learn the content of a specific meeting, obtain meeting summaries, download meeting verbatim transcripts, etc.

5installs
Sourceriba2534/feishu-cli
Added on

NPX Install

npx skill4agent add riba2534/feishu-cli feishu-cli-vc

Tags

Translated version includes tags in frontmatter
feishu-climeeting-managementproductivity-toolcommand-line-toolfeishu-minutes

SKILL.md Content (Chinese)

View Translation Comparison →

Feishu Video Conferencing and Minutes

Search for historical meeting records, obtain meeting minutes and verbatim transcripts, and view basic Minutes information.
feishu-cli: If you have not installed it yet, please go to riba2534/feishu-cli to get the installation method.

Prerequisites

  • Authentication: Valid App Access Token is required (environment variables 
    FEISHU_APP_ID
    + 
    FEISHU_APP_SECRET
    , or 
    ~/.feishu-cli/config.yaml
    )
  • Permissions: The application needs to enable 
    vc:room:readonly
    (meeting room read-only), 
    vc:meeting:readonly
    (meeting record read-only), 
    minutes:minutes:readonly
    (Minutes read-only)
  • Verification: Run 
    feishu-cli auth status
    to confirm the authentication status is normal

Command Quick Reference

Search Historical Meetings

Search the historical records of Feishu video conferences, support filtering by time range, meeting number, and meeting status.
bash
feishu-cli vc search [options]
ParameterTypeDescription
--start
stringStart time (Unix timestamp in seconds)
--end
stringEnd time (Unix timestamp in seconds)
--meeting-no
stringExact match of meeting number
--meeting-status
intMeeting status (1=in progress, 2=ended)
--page-size
intNumber of items per page (default 20)
--page-token
stringPagination token (returned from previous page)
-o json
stringOutput in JSON format

Get Meeting Minutes

Obtain the minutes content of the specified meeting (including structured summary and verbatim transcript). Choose either 
--meeting-id
or 
--minute-token
, they are mutually exclusive.
bash
feishu-cli vc notes [options]
ParameterTypeDescription
--meeting-id
stringObtain minutes by meeting ID (mutually exclusive with 
--minute-token
)
--minute-token
stringObtain minutes by Minutes token (mutually exclusive with 
--meeting-id
)
-o json
stringOutput in JSON format

Get Basic Minutes Information

Obtain the metadata of Minutes (title, creation time, duration, participants, etc.).
bash
feishu-cli minutes get <minute_token> [options]
ParameterTypeDescription
<minute_token>
stringMinutes token (required, positional parameter)
-o json
stringOutput in JSON format

Usage Examples

bash
# Search for meetings in the last week (assuming current timestamp is 1711584000)
feishu-cli vc search --start 1710979200 --end 1711584000

# Search for ended meetings
feishu-cli vc search --meeting-status 2

# Exact search by meeting number
feishu-cli vc search --meeting-no "123456789"

# Get more meeting records with pagination
feishu-cli vc search --page-size 50

# Get meeting minutes by meeting ID
feishu-cli vc notes --meeting-id "6911xxxxx"

# Get minutes by Minutes token
feishu-cli vc notes --minute-token "obcnxxxxx"

# Get basic Minutes information
feishu-cli minutes get obcnxxxxx

# Output in JSON format (easy for program parsing)
feishu-cli vc search --meeting-status 2 -o json
feishu-cli minutes get obcnxxxxx -o json

Typical Workflow

Find a meeting and get its minutes

bash
# 1. Search for meetings within the time range
feishu-cli vc search --start 1710979200 --end 1711584000 -o json
# → Get the meeting_id of the target meeting

# 2. Get meeting minutes
feishu-cli vc notes --meeting-id "<meeting_id>"
# → Output meeting summary and verbatim transcript

# 3. If you have Minutes token, you can also view Minutes details
feishu-cli minutes get <minute_token>

Permission Requirements

FunctionRequired Permission
Search meeting records
vc:meeting:readonly
Meeting room information
vc:room:readonly
Get Minutes information
minutes:minutes:readonly

Notes

  • Time parameters: 
    --start
    and 
    --end
    use Unix timestamp in seconds (not milliseconds), you can get the current timestamp via 
    date +%s
  • meeting-id vs minute-token: The two parameters of 
    vc notes
    are mutually exclusive and cannot be used at the same time; meeting-id comes from the result of 
    vc search
    , minute-token comes from Minutes URL or the return of 
    minutes get
  • Minutes token source: Feishu Minutes URL format is 
    https://xxx.feishu.cn/minutes/<minute_token>
    , you can extract it from the URL
  • Data timeliness: Meeting records and Minutes can only be queried after the meeting ends for a period of time, and minutes cannot be obtained for real-time meetings
  • Permission application: 
    vc:meeting:readonly
    and 
    minutes:minutes:readonly
    need to be applied separately on Feishu Open Platform