SkillsMar 30, 2026·1 min read

Lark CLI Skill: Sheets — Spreadsheet Operations

Lark/Feishu CLI skill for spreadsheets. Create, read, write, append, find, and export spreadsheet data.

TL;DR
Lark CLI skill that lets AI agents create, read, write, and export Lark/Feishu spreadsheets from the command line.
§01

What it is

Lark CLI Skill: Sheets is a command-line skill for managing Lark/Feishu spreadsheets. It provides operations for creating spreadsheets with headers and data, reading and writing cells, appending rows, finding content, and exporting to files. It is part of the Lark CLI toolset, which offers 200+ commands and 19 AI Agent Skills.

It is designed for teams using Lark/Feishu for workplace collaboration who want to automate spreadsheet operations via AI agents or scripts.

§02

How it saves time or tokens

The token estimate for this workflow is 500 tokens. Instead of navigating the Lark UI manually, the skill lets AI agents read and write spreadsheet data programmatically. Batch operations like appending rows or finding values across sheets complete in a single command rather than multiple UI interactions.

§03

How to use

  1. Install the Lark CLI: npm install -g @larksuite/cli
  2. Install the skill: npx skills add larksuite/cli -y -g
  3. Configure authentication: lark-cli config init && lark-cli auth login --recommend
  4. Use spreadsheet commands in your AI agent or terminal
§04

Example

# Install Lark CLI
npm install -g @larksuite/cli

# Install the sheets skill
npx skills add larksuite/cli -y -g

# Configure (one-time)
lark-cli config init
lark-cli auth login --recommend

# Create a new spreadsheet
lark-cli sheets create --title 'Project Tracker' \
  --headers 'Task,Status,Assignee,Due Date'

# Read data from a spreadsheet
lark-cli sheets read --spreadsheet-token <token> --range 'A1:D10'

# Append rows
lark-cli sheets append --spreadsheet-token <token> \
  --values 'Review PR,In Progress,Alice,2026-04-20'
§05

Related on TokRepo

§06

Common pitfalls

  • Authentication tokens expire; run lark-cli auth login --recommend periodically to refresh credentials
  • Spreadsheet tokens are different from document tokens; use the correct token type for sheets operations
  • The skill requires an active Lark/Feishu app with spreadsheet permissions configured in the developer console

Frequently Asked Questions

What spreadsheet operations does this skill support?+

The skill supports creating spreadsheets with headers and data, reading cells by range, writing to specific cells, appending rows, finding content by keyword, and exporting spreadsheet data to local files.

Does this work with Feishu (the Chinese version)?+

Yes. Lark and Feishu share the same API infrastructure. The CLI skill works with both Lark (international) and Feishu (China) workspaces. Configure the appropriate region during setup.

Which AI tools can use this skill?+

The skill follows the Agent Skills Standard and is compatible with Claude Code, OpenAI Codex, Cursor, and Gemini CLI. Install with npx skills add larksuite/cli and it activates automatically when relevant tasks are detected.

Do I need a paid Lark plan?+

The API access required for spreadsheet operations is available on Lark's free tier. However, some advanced features and higher API rate limits may require a paid plan depending on your usage volume.

How do I find the spreadsheet token?+

The spreadsheet token is part of the URL when you open a spreadsheet in Lark. It appears after /sheets/ in the URL. You can also list available spreadsheets using the CLI to find tokens programmatically.

Citations (3)
🙏

Source & Thanks

Created by LarkSuite. Licensed under MIT. larksuite/cli — 4,100+ GitHub stars

Part of the Lark CLI Official Skills Collection on TokRepo.

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.