# Lark CLI

> Interact with Lark/Feishu Open Platform using the official CLI tool. Use this skill when the user wants to manage calendar events, send messages, work with documents, manage spreadsheets, handle tasks, or interact with any Lark/Feishu business domain. Supports both user-level (OAuth) and bot-level (App ID/Secret) authentication.

- Skill: `xpert-ai/lark-cli` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add xpert-ai/lark-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xpert-ai/lark-cli/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: xpert-ai (https://skillmd.com/u/xpert-ai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/xpert-ai/lark-cli

---


# Lark CLI - Lark/Feishu Open Platform Integration

A command-line tool for Lark/Feishu Open Platform with 200+ commands and AI Agent Skills covering Calendar, Messenger, Docs, Base, Sheets, Slides, Tasks, Mail, Meetings, and more.

## Installation

The Lark CLI is automatically installed in the sandbox via npm:

```bash
npm install -g @larksuite/cli@1.0.93
```

## Authentication

### User Mode (OAuth)

For user-level operations, use OAuth login:

```bash
# Interactive login with recommended scopes
lark-cli auth login --recommend

# Login with specific domain scopes
lark-cli auth login --domain calendar,messenger

# Check authentication status
lark-cli auth status
```

### Bot Mode (App ID/Secret)

For bot-level operations, configure App ID and Secret through middleware config. The credentials are securely provisioned in the sandbox.

## Available Skills

The following skills are downloaded from the larksuite/cli GitHub repository:

- `lark-shared` - App config, auth login, identity switching (auto-loaded)
- `lark-calendar` - Calendar events, agenda, free/busy queries
- `lark-im` - Send/reply messages, group chat management
- `lark-doc` - Create, read, update documents
- `lark-drive` - Upload, download files, manage permissions
- `lark-sheets` - Create, read, write spreadsheets
- `lark-slides` - Plan, create, validate, inspect, and edit native Feishu presentations
- `lark-base` - Tables, fields, records, dashboards
- `lark-task` - Tasks, task lists, subtasks
- `lark-mail` - Browse, search, send emails
- `lark-contact` - Search users, get profiles
- `lark-wiki` - Knowledge spaces, nodes
- `lark-event` - Real-time event subscriptions
- `lark-vc` - Meeting records, minutes
- `lark-whiteboard` - Whiteboard/chart rendering
- `lark-minutes` - Meeting minutes metadata
- `lark-openapi-explorer` - Explore underlying APIs
- `lark-skill-maker` - Custom skill creation
- `lark-workflow-meeting-summary` - Meeting summary workflow
- `lark-workflow-standup-report` - Standup report workflow

## Usage Examples

### Calendar

```bash
# View today's agenda
lark-cli calendar +agenda

# Create an event
lark-cli calendar +create --title "Team Meeting" --start "2024-01-15T10:00:00" --end "2024-01-15T11:00:00"
```

### Messenger

```bash
# Send a message to a chat
lark-cli im +messages-send --chat-id "oc_xxx" --text "Hello from AI Agent!"

# List recent chats
lark-cli im +chats
```

### Documents

```bash
# Create a document
lark-cli doc +create --title "Weekly Report" --markdown "# Progress\n- Completed feature X"

# Read a document
lark-cli doc +read --doc-id "doxcn_xxx"
```

### Sheets

```bash
# Read spreadsheet data
lark-cli sheets +read --spreadsheet-token "shtcn_xxx" --range "A1:D10"

# Write data to a sheet
lark-cli sheets +write --spreadsheet-token "shtcn_xxx" --range "A1" --values '[["Name", "Value"], ["Test", "123"]]'
```

### Slides / PPT

Before creating or editing a presentation, read `lark-slides/SKILL.md` and every operation-specific reference it requires. For new decks and major rewrites, follow the complete planning and validation workflow:

1. Create `.lark-slides/plan/<deck-id>/slide_plan.json`.
2. Generate one complete SML `<slide>` XML file per page.
3. Run `lark-slides/scripts/xml_lint.py`; publish only when `summary.error_count` is zero.
4. Create or update the deck with `lark-cli slides` using `--as user` by default.
5. Read the deck back with `slides +xml-get`, validate it, and use `slides +screenshot` when available before returning the Feishu link.

```bash
lark-cli auth login --domain slides
lark-cli slides +create --as user --title "Project update" --slide @.lark-slides/plan/project/slide-01.xml
lark-cli slides +xml-get --as user --presentation <xml_presentation_id> --output .lark-slides/plan/project/readback.xml
```

The Slides skill guides the Agent and `lark-cli` executes official Open Platform operations. It does not invoke Feishu's private Doubao PPT product or the Feishu template gallery.

For a finished presentation that also needs a local copy, use `lark-cli drive +export` with
`.pptx` and save the result inside the current sandbox working directory. Return the
sandbox-relative path together with the Feishu Slides link. No Xpert workspace import is needed
for this workflow.

## Identity Switching

Execute commands as user or bot:

```bash
# As user (default)
lark-cli calendar +agenda --as user

# As bot
lark-cli im +messages-send --as bot --chat-id "oc_xxx" --text "Bot message"
```

## Output Formats

```bash
# JSON output (default)
lark-cli calendar +agenda --format json

# Table format
lark-cli calendar +agenda --format table

# CSV format
lark-cli sheets +read --spreadsheet-token "xxx" --format csv
```

## Dry Run

Preview operations before executing:

```bash
lark-cli im +messages-send --chat-id "oc_xxx" --text "Test" --dry-run
```

## Troubleshooting

- `auth login` required: Run `lark-cli auth login --recommend` first
- Permission denied: Check if the required scopes are granted
- Command not found: Ensure `@larksuite/cli` is installed globally
- Network issues: Check internet connectivity for API calls

## Security Notes

- Credentials are securely stored in the OS keychain
- Bot credentials are provisioned via secure file upload
- Never hardcode secrets in commands
- Use `--dry-run` for potentially destructive operations