Skip to content

lark-cli

Official command-line tool for Lark/Feishu, aimed at both people and AI agents.larksuite/cli

Stars
17.9k
Forks
1.4k
Licence
MIT
Language
Go
Last update
4 days ago
Type
CLI

What it is

lark-cli is the official command-line tool from the larksuite team for the Lark/Feishu workplace platform. It lets you work with Messenger, Docs, Sheets, Calendar, Mail, Tasks, Meetings and other Lark areas from a terminal, using commands such as lark-cli calendar +agenda. It is also designed so AI agents can call the same commands through a set of bundled agent Skills.

  • Check your calendar agenda or find free time from the terminal
  • Send or reply to messages and search chat history
  • Create, read, or update Docs and Sheets data
  • Query tasks, approvals, or meeting records

Great for

  • Developers who want to script Lark/Feishu tasks from a terminal
  • Teams automating calendar, messaging, or document workflows
  • People who want an AI agent to operate Lark with structured commands
  • Enterprise IT teams embedding the CLI in their own agent platform (README describes this path)

Not ideal for

  • Users who only need the Lark web or mobile app, since this is a terminal tool
  • Anyone without a Lark/Feishu account and app credentials, because setup requires them
  • Teams needing a non-Lark platform integration
Step-by-step guide: how to use lark-cliInstall, first run, examples, tips and FAQs

How to get it

  1. 1

    Install with a package manager

    You'll need: Node.js (npm/npx) · Go 1.23+ and Python 3 (only for building from source)

    Install via npm (recommended)

    npx @larksuite/cli@latest install

    Clone source

    git clone https://github.com/larksuite/cli.git
  2. 2

    Run it

    • Install the CLI with npx @larksuite/cli@latest install
    • Configure app credentials with lark-cli config init
    • Log in with lark-cli auth login --recommend
    • Try a command such as lark-cli calendar +agenda
  3. 3

    Get the most out of it

    • Use the bundled agent Skills (for example lark-calendar, lark-im, lark-doc) with your AI tool
    • Use --recommend at login to auto-select commonly used scopes
    • Check your setup with lark-cli auth status
    • Review the Security section of the README before enabling broad permissions

Downloads

Strengths

  • Official tool maintained by the larksuite team, under the MIT license
  • Covers many Lark business areas with 200+ commands according to the README
  • Includes structured output and bundled AI agent Skills

Trade-offs

  • Requires app credential setup and a browser-based login before real use
  • Some README sections were truncated, so full command coverage is not verified here
  • Install and auth flow involves several steps, which may be confusing for beginners

Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.