Lark CLI — 19 AI Agent Skills for Lark/Feishu
Command-line tool for Lark/Feishu Open Platform with 200+ commands and 19 AI Agent Skills. Covers Messenger, Docs, Base, Sheets, Calendar, Mail, Tasks, and more.
What it is
Lark CLI is a command-line tool for the Lark/Feishu Open Platform, designed for both humans and AI agents. It provides 200+ commands covering 11 core business domains and packages them into 19 AI agent skills that coding assistants like Claude Code, Cursor, and OpenAI Codex can use directly. Lark (international) and Feishu (China) are ByteDance's workplace collaboration platform, used by millions of knowledge workers.
The toolkit is MIT licensed and available as an npm package. It covers messaging, documents, spreadsheets, calendar, tasks, email, wiki, drive, meetings, contacts, and more. Each domain has a dedicated skill that exposes curated commands for common operations, plus an OpenAPI Explorer for accessing any raw Lark API endpoint.
How it saves time or tokens
Before Lark CLI, automating Lark operations required writing custom code against the Open Platform REST APIs: handling OAuth, constructing request bodies, parsing responses, and managing pagination. Each integration took hours of development time. With Lark CLI, an AI agent installs the skills and immediately has structured access to all Lark operations through simple CLI commands.
The 19 pre-built skills also reduce token consumption. Instead of an AI agent reasoning through raw API documentation, it uses the skill's curated command interface. The skill handles API details internally, so the agent's prompt only needs the command name and parameters, not the full API specification.
How to use
- Install Lark CLI and all 19 skills:
```bash
npm install -g @larksuite/cli
npx skills add larksuite/cli -y -g
```
- Configure and authenticate:
```bash
lark-cli config init
lark-cli auth login --recommend
```
- Start using any skill:
```bash
lark-cli calendar +agenda
lark-cli im +messages-send --chat-id 'oc_xxx' --text 'Hello'
lark-cli task +create --summary 'Review PR'
```
Example
The 19 skills organized by domain:
| Domain | Skills | Key Commands |
|---|---|---|
| Communication | Messenger, Mail, Contact | Send messages, email, search users |
| Documents | Docs, Sheets, Base, Drive, Wiki | Create, read, update documents and files |
| Planning | Calendar, Tasks | Schedule events, manage todos |
| Meetings | Meetings, Minutes | Access recordings, transcripts, summaries |
| Events | Events | Subscribe to platform events |
| Visual | Whiteboard | Render charts and diagrams |
| Meta | Shared, OpenAPI Explorer, Skill Maker | Auth, raw API access, custom skill creation |
| Workflows | Meeting Summary, Standup Report | Composite multi-skill automations |
A typical multi-skill workflow:
# Morning routine automated by an AI agent:
# 1. Check today's agenda
lark-cli calendar +agenda
# 2. Get pending tasks
lark-cli task +list --status open
# 3. Generate and post standup report
lark-cli standup +run --chat-id 'oc_teamchat'
# 4. Check new messages
lark-cli im +messages-list --chat-id 'oc_teamchat' --page-size 5
Related on TokRepo
- AI Tools for Automation — Browse automation tools and compare with Lark CLI's approach.
- AI Tools for Task Management — Explore task management tools that complement Lark's built-in system.
Common pitfalls
- Trying to use skills before completing authentication. All 19 skills depend on the Shared skill's auth configuration. Run
lark-cli config initandlark-cli auth login --recommendfirst. Every other command will fail without valid credentials. - Not configuring the correct region. Lark (international) and Feishu (China) use different API endpoints. If your workspace is on Feishu but the CLI targets Lark, all requests fail. Set the correct endpoint during
config init. - Installing the CLI without installing the skills. The npm package provides the CLI binary, but the 19 skills are installed separately via
npx skills add larksuite/cli -y -g. Without this step, only basic CLI commands are available.
Frequently Asked Questions
Lark is the international version of ByteDance's workplace platform, serving users outside China. Feishu is the China version. They share the same core features (messaging, docs, calendar, video conferencing) but use separate API endpoints and data centers. The Lark CLI supports both platforms through endpoint configuration.
The CLI provides over 200 commands across 19 skills, covering 11 core business domains. Each skill bundles a set of commands for its domain. For example, the Messenger skill includes commands for sending messages, listing chats, and managing chat members. The OpenAPI Explorer provides access to additional API endpoints beyond what the domain skills cover.
The skills work with Claude Code, OpenAI Codex, Cursor, Gemini CLI, and any AI coding tool that supports the skills protocol. The AI agent installs the skills and receives structured command documentation, enabling it to make correct API calls without reading raw API documentation.
Yes. The CLI and all 19 skills are MIT licensed and free. However, using the Lark Open Platform APIs requires a Lark workspace and an app with appropriate permission scopes. Some advanced API features may require a paid Lark workspace plan.
Yes. The Skill Maker skill helps you scaffold, build, and package custom skills. Custom skills can combine multiple Lark APIs into higher-level operations specific to your organization. They run in the same CLI context and share authentication with the built-in skills.
Citations (3)
- Lark CLI GitHub Repository— Lark CLI with 200+ commands and 19 AI agent skills
- Lark Developer Documentation— Lark Open Platform for building workplace integrations
- Lark Official Website— Lark/Feishu workplace collaboration platform
Related on TokRepo
Source & Thanks
Created by LarkSuite. Licensed under MIT. larksuite/cli — 4,100+ GitHub stars larksuite.com
Discussion
Related Assets
Claude-Flow — Multi-Agent Orchestration for Claude Code
Layers swarm and hive-mind multi-agent orchestration on top of Claude Code with 64 specialized agents, SQLite memory, and parallel execution.
ccusage — Real-Time Token Cost Tracker for Claude Code
CLI that reads ~/.claude logs and breaks down Claude Code token spend by day, session, and project — pluggable into your statusline.
SuperClaude — Workflow Framework for Claude Code
Adds 16+ slash commands, 9 cognitive personas, and a smart flag system to Claude Code in one pipx install.