bitable

Lark Bitable Skill

Access Lark Bitable (database) content via the lark CLI.

Running Commands

Ensure lark is in your PATH, or use the full path to the binary:

lark bitable <command>

Commands Reference

List Tables

lark bitable tables <app_token>

Lists all tables in a Bitable app. The app_token is from the Bitable URL.

For example, if the URL is https://xxx.larksuite.com/base/ABC123xyz, the app_token is ABC123xyz.

Output:

{
  "app_token": "ABC123xyz",
  "tables": [
    {
      "table_id": "tblXYZ789",
      "name": "Projects"
    },
    {
      "table_id": "tblABC456",
      "name": "Tasks"
    }
  ],
  "count": 2
}

List Fields

lark bitable fields <app_token> <table_id>

Lists all fields (columns) in a Bitable table.

Output:

{
  "app_token": "ABC123xyz",
  "table_id": "tblXYZ789",
  "fields": [
    {
      "field_id": "fldAAA111",
      "field_name": "Name",
      "type": "text",
      "is_primary": true
    },
    {
      "field_id": "fldBBB222",
      "field_name": "Status",
      "type": "select"
    },
    {
      "field_id": "fldCCC333",
      "field_name": "Due Date",
      "type": "date"
    }
  ],
  "count": 3
}

Field types: text, number, select, multi_select, date, checkbox, person, phone, url, attachment, link, formula, duplex_link, location, group, created_time, created_user, modified_time, modified_user, auto_number

List Records

lark bitable records <app_token> <table_id> [--limit N] [--view <view_id>] [--filter <expression>]

Lists records (rows) in a Bitable table.

Options:

• --limit: Maximum number of records to retrieve (default: no limit)
• --view: View ID to filter records
• --filter: Filter expression (see Lark API docs for syntax)

Output:

{
  "app_token": "ABC123xyz",
  "table_id": "tblXYZ789",
  "records": [
    {
      "record_id": "recAAA111",
      "fields": {
        "Name": "Project Alpha",
        "Status": "In Progress",
        "Due Date": 1704067200000
      }
    },
    {
      "record_id": "recBBB222",
      "fields": {
        "Name": "Project Beta",
        "Status": "Completed",
        "Due Date": 1703462400000
      }
    }
  ],
  "count": 2,
  "has_more": false
}