Lark-CLI: Official Lark/Feishu CLI for AI Agents
Discover lark-cli, the official open-source CLI for Lark/Feishu platforms. Built for humans and AI agents alike, it offers 200+ commands across 12 business domains including Calendar, Messenger, Docs, Sheets, Mail, and Tasks. With 20 structured AI Agent Skills, agent-native design, and zero-setup integration, get up and running in 3 minutes. Features three-layer architecture (shortcuts โ API commands โ raw APIs), enterprise-grade security, and MIT license. Perfect for developers automating Lark workflows.
Lark-CLI: The Ultimate CLI Tool for Lark/Feishu Automation
Lark/Feishu users rejoice! The official lark-cli from the larksuite team has been open-sourced under MIT license, bringing 200+ commands and 20 AI Agent Skills to your terminal.
Why Choose lark-cli?
๐ฏ Agent-Native Design
- 20 structured Skills ready for popular AI tools
- Zero extra setup for AI agents
- Concise parameters with smart defaults
- Structured JSON output for maximum agent success rates
๐ Comprehensive Coverage
๐
Calendar ๐ฌ Messenger ๐ Docs
๐ Drive ๐ Base ๐ Sheets
โ
Tasks ๐ Wiki ๐ค Contact
๐ง Mail ๐ฅ Meetings โ๏ธ Approval
๐ 3-Minute Quick Start
# Install (npm recommended)
npm install -g @larksuite/cli
npx skills add larksuite/cli -y -g
# Configure & Login
lark-cli config init
lark-cli auth login --recommend
# First command
lark-cli calendar +agenda
๐ ๏ธ Three-Layer Architecture
1. Shortcuts (+ prefixed) - Human & AI friendly
lark-cli im +messages-send --chat-id "oc_xxx" --text "Hello"
lark-cli docs +create --title "Report" --markdown "# Progress"
2. API Commands - Platform synced
lark-cli calendar events instance_view --params '{...}'
3. Raw API - Full 2500+ endpoint coverage
lark-cli api POST /open-apis/im/v1/messages --body '{...}'
๐ค AI Agent Skills (20 Total)
| Skill | Domain |
|---|---|
lark-calendar |
Events, agenda, free/busy |
lark-im |
Messages, chats, media |
lark-sheets |
Spreadsheet CRUD |
lark-base |
Database operations |
lark-mail |
Email automation |
lark-approval |
Approval workflows |
๐ Enterprise Security
- Input injection protection
- Terminal output sanitization
- OS-native keychain storage
- Identity switching (user/bot)
- Dry-run previews
๐ Advanced Features
# Output formats
--format json | pretty | table | csv
# Pagination
--page-all | --page-limit 5
# Schema inspection
lark-cli schema im.messages.send
๐ฏ Perfect For
- Developers: Automate Lark workflows
- AI Builders: Agent-ready Skills
- Admins: Bulk operations & reporting
- Teams: Meeting automation & approvals
Star History: 6.4k โญ | 350 forks | MIT License
Get started today: npm install -g @larksuite/cli
โ ๏ธ Security Note: Understand risks when authorizing AI agents. Use private bots only.