SkillsMar 30, 2026·2 min read

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.

TL;DR
A command-line toolkit with 200+ commands and 19 AI agent skills for automating Lark/Feishu workplace operations.
§01

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.

§02

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.

§03

How to use

  1. Install Lark CLI and all 19 skills:

```bash

npm install -g @larksuite/cli

npx skills add larksuite/cli -y -g

```

  1. Configure and authenticate:

```bash

lark-cli config init

lark-cli auth login --recommend

```

  1. 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'

```

§04

Example

The 19 skills organized by domain:

DomainSkillsKey Commands
CommunicationMessenger, Mail, ContactSend messages, email, search users
DocumentsDocs, Sheets, Base, Drive, WikiCreate, read, update documents and files
PlanningCalendar, TasksSchedule events, manage todos
MeetingsMeetings, MinutesAccess recordings, transcripts, summaries
EventsEventsSubscribe to platform events
VisualWhiteboardRender charts and diagrams
MetaShared, OpenAPI Explorer, Skill MakerAuth, raw API access, custom skill creation
WorkflowsMeeting Summary, Standup ReportComposite 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
§05

Related on TokRepo

§06

Common pitfalls

  • Trying to use skills before completing authentication. All 19 skills depend on the Shared skill's auth configuration. Run lark-cli config init and lark-cli auth login --recommend first. 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

What is the difference between Lark and Feishu?+

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.

How many API commands does Lark CLI provide?+

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.

Which AI coding tools work with Lark CLI skills?+

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.

Is Lark CLI free to use?+

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.

Can I build custom skills on top of Lark CLI?+

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)
🙏

Source & Thanks

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

Discussion

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

Related Assets