Lark CLI
MIT-licensed official CLI for Lark and Feishu (飞书), from ByteDance. 200+ commands and 24 agent skills over Docs, Base, Sheets, Calendar and approvals, built for AI agents.
Overview
ByteDance open sourced the official Lark and Feishu command-line tool under MIT on 28 March 2026, and it turned out to be considerably more than a convenience wrapper. The design goal stated in the repository is that scripts and AI agents should be able to work with Lark the way they work with local files. In practice that means 200-plus commands across roughly eighteen business domains, from Messenger and Calendar to Base, Sheets, Slides, Wiki, Drive, Mail, Tasks and multi-step approval chains, all reachable from a shell.
The agent story is the reason it matters. The repository ships 24-plus packaged AI Agent Skills that install into Claude Code, Codex and Cursor, so an agent can read a chat thread, pull the meeting minutes, edit a Base record, update a document from its comments and push an approval back for revision, with each step scoped by OAuth rather than by a shared token. Architecture is three-layered: hand-written shortcuts for common tasks, generated commands that track the Open Platform API spec and raw passthrough for anything not yet wrapped. Output formats include NDJSON, which makes agent-driven data analysis workflows practical instead of theoretical.
The China-specific detail that catches teams out is tenancy. Feishu is the mainland product with mainland data residency and governance. Lark is the international product. They are separate installations, accounts do not federate, and each needs its own app registration with its own scopes. The CLI supports both, which is genuinely useful, but it does not paper over the split. Documentation is Chinese-first with English pages on open.larksuite.com running behind. And it is young: v1.0.92 on 28 August 2026, after ninety-plus releases since March, with commands still being added and refined weekly. Pin your version if you are building anything that has to keep working.
Key Features
- ✓ MIT licensed, open sourced by the Lark team on 28 March 2026, at v1.0.92 as of 28 August 2026 with releases shipping most days
- ✓ 200+ commands spanning roughly 18 business domains including Messenger, Docs, Base, Sheets, Slides, Wiki, Drive, Calendar, Mail, Tasks, Meetings and approvals
- ✓ 24+ packaged AI Agent Skills that install into Claude Code, Codex and Cursor, letting an agent read a thread, edit a Base record and send an approval back for revision without a bespoke integration
- ✓ Three layers of access: human-friendly shortcuts, generated API commands that track the Open Platform spec and raw API passthrough for anything not yet wrapped
- ✓ OAuth login with scope management, identity switching between user and bot contexts and tokens held in the OS-native keychain
- ✓ Output in JSON, table, CSV and NDJSON, plus documented input-injection defences, so it scripts cleanly instead of only working interactively
Where it holds
- • Genuinely MIT, published by ByteDance, sitting on a product that a very large share of Chinese white-collar teams already run daily
- • One tool covers both Feishu (mainland tenant) and Lark (international tenant), so a single script can target either side of the data boundary
- • Security thinking is present from the start: keychain-backed token storage, scoped OAuth and injection defences rather than a raw token in an environment variable
- • Release cadence is genuinely fast, with over 100 new capabilities added within about six weeks of the initial open sourcing
Where it breaks
- • Needs a Lark or Feishu tenant and a custom app registration with correct scopes. The CLI is free, the platform it drives is not necessarily
- • Feishu and Lark are separate installations with separate data residency and no account federation, so a mainland org and an overseas org require two setups and two app registrations
- • Documentation is strongest in Chinese. English pages exist on open.larksuite.com but lag the Chinese ones, and some Base and approval semantics are only properly explained in Chinese
- • Very young and moving fast. Ninety-two patch releases in five months means the command surface is still shifting under any automation you write against it
My Take
Open sourcing this in March 2026 was the most interesting move any Chinese office suite made all year. A Go and Python CLI under MIT that exposes 200-plus commands across Messenger, Docs, Base, Sheets, Calendar and approvals, with 24 packaged agent skills that install straight into Claude Code or Cursor. The catch is tenancy: Feishu and Lark are separate installations with separate data residency and no federation, so a script that works against your Shenzhen org needs a second app registration for the Singapore one. Version 1.0.92 shipped on 28 August 2026, which tells you both how alive the project is and how much the surface is still moving.
Quick Info
- Pricing:
- open-source
- Openness:
- Open source
- Licence:
- MIT
- Starting at:
- The CLI itself is free under MIT with no usage limits or licence keys. What costs money is the platform underneath. Lark and Feishu both have free tiers that are workable for small teams, with paid plans adding storage, admin controls, advanced Base automation and higher API rate limits. Using the CLI requires a tenant plus a custom app registration in the Open Platform console, which is free to create. Open Platform API rate limits are tied to your tenant plan, so heavy agent traffic can push you into a paid tier on volume rather than features.
- Added:
- Aug 2026
- Updated:
- Aug 2026
Use Cases
Judge it on your own work
The notes above say where Lark CLI holds and where it breaks. The fastest check is your own workload.
Visit website ↗