larksuite /cli

The official Lark/飞书 CLI tool, maintained by the larksuite team — built for humans and AI Agents. Covers core business domains including Messenger, Docs, Base, Sheets, Calendar, Mail, Tasks, Meetings, and more, with 200+ commands and 20+ AI Agent Skills.

★ 18,118⑂ 1,377👁 54⑃ 2,230● 680▤ 111
GoMITCreated 2026-03-25
下载:v1.0.100v1.0.100 ↓1.0.1002026-11-10
+7
日增长
18,118
stars
1,377
forks
54
watchers
2,230
prs
680
issues
111
releases

README

lark-cli





中文版 | English

The official Lark/Feishu CLI tool, maintained by the larksuite team — built for humans and AI Agents. Covers core business domains including Messenger, Docs, Base, Sheets, Slides, Calendar, Mail, Tasks, Meetings, Markdown, and more, with 200+ commands and 26 AI Agent Skills.

Install · AI Agent Skills · Auth · Commands · Advanced · Enterprise · Security · Contributing

 Why lark-cli?

- Agent-Native Design — 24 structured Skills out of the box, compatible with popular AI tools — Agents can operate Lark with zero extra setup
- Wide Coverage — 18 business domains, 200+ curated commands, 26 AI Agent Skills
- AI-Friendly & Optimized — Every command is tested with real Agents, featuring concise parameters, smart defaults, and structured output to maximize Agent call success rates
- Open Source, Zero Barriers — MIT license, ready to use, just npm install
- Up and Running in 3 Minutes — One-click app creation, interactive login, from install to first API call in just 3 steps
- Secure & Controllable — Input injection protection, terminal output sanitization, OS-native keychain credential storage
- Three-Layer Architecture — Shortcuts (human & AI friendly) → API Commands (platform-synced) → Raw API (full coverage), choose the right granularity

 Personal or Enterprise?

| You are... | Recommended path |
| ---------- | ---------------- |
| An individual developer — using lark-cli in your terminal or with your own AI Agent | Follow the Quick Start below |
| Enterprise IT / ISV — embedding lark-cli into your own Agent or platform, with centralized credentials (database / Vault / config center), unified audit logging, and a restricted command surface | Read Embed lark-cli in your Agent and the extension/ packages — extend via a wrapper main, no need to modify CLI source |

 💡 For AI Agents: append .md to any Open Platform doc URL to fetch it as raw Markdown, e.g. embed-feishu-cli-in-agent.md.

 Features

| Category      | Capabilities                                                                                                                      |
| ------------- |-----------------------------------------------------------------------------------------------------------------------------------|
| 📅 Calendar   | View, create and update events, invite attendees, find meeting rooms, RSVP to invitations, check free/busy & time suggestions     |
| 💬 Messenger  | Send/reply messages, create and manage group chats, view chat history & threads, search messages, download media                  |
| 📄 Docs       | Create, read, update, and search documents, read/write media & whiteboards                                                        |
| 📁 Drive      | Upload and download files, search docs & wiki, manage comments                                                                    |
| 📝 Markdown   | Create, fetch, patch, and overwrite Drive-native .md files                                                                      |
| 📊

Top issues

Latest release

v1.0.100 v1.0.100 2026-11-10
Changelog
 0d0782f252f957bdf3308317322a55e8a6630ac8 fix(apps): classify database precondition subcodes (2900)
 fbb292df233aa0540acdba300d9ea7bec38389a0 fix(apps): name export's real gate and reject unusable ids and paths (2899)
 7dbefd9cf17357545450ca53007d413212bc8aba fix(apps): recognize feishuapp runtime domains (2906)
 05ac58ffa089fe7a171205ac1d1e97ee50196ec8 fix: scope apps recovery hints to failure causes (2897)

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON