lark-tools

Operate Feishu/Lark calendars, messages, docs, and Bitable via the lark-cli terminal binary.

1.3k|142|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/MiniMax-AI/minimax-code --skill lark-tools-minimax-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-tools
Source: https://github.com/MiniMax-AI/minimax-code/tree/main/packages/local-runtime/assets/skills/lark-tools
Command: npx skills add https://github.com/MiniMax-AI/minimax-code --skill lark-tools-minimax-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @larksuite/cli, and includes references (resource) components.

What problem does it solve? Working with Feishu/Lark from a terminal agent normally requires juggling dozens of APIs, OAuth scopes, and platform-specific shell commands, and plain web fetching of feishu.cn links returns anti-bot pages instead of content. This Skill routes every Feishu/Lark operation through the official lark-cli binary with correct authentication, identity selection, and per-domain sub-skill guidance. ## Core Features & Use Cases - Full Feishu surface via lark-cli: calendar agendas and event creation, IM message send/reply, contact search, tasks, docs, sheets, Bitable records, wiki, mail, minutes, and video conference records. - Link-based document reading: paste any feishu.cn or larksuite.com URL (docx, wiki, sheets, base) and it routes to the correct lark-cli command instead of webfetch, which Feishu blocks with anti-bot pages. - Auth and bot binding management: handles bot binding through local-runtime channel config, user OAuth via lark-cli auth login, and recovery from 401 or missing-scope errors, with platform-specific command recipes for macOS/Linux and Windows PowerShell. - Use Case: A user pastes a Feishu wiki link and asks for a summary; the Skill resolves the wiki token, fetches the document with lark-cli docs +fetch, and returns the content without ever hitting the anti-bot wall. ## Quick Start Ask the agent to show today's Feishu schedule or read a pasted feishu.cn document link, and it will run the appropriate lark-cli command after checking auth status.

Frequently Asked Questions about lark-tools

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I read a Feishu document from a link in the terminal?

Use lark-cli docs +fetch --doc "<url>" for docx and wiki links, lark-cli sheets +read for /sheets/ links, and lark-cli base +record-list for /base/ links. Do not use webfetch, because Feishu serves an anti-bot ad page to plain HTTP fetchers.

How do I check today's Feishu calendar schedule from the command line?

Run lark-cli calendar +agenda --as user --format json to get today's agenda. You must first bind a Feishu bot and complete user OAuth with lark-cli auth login --recommend so the required calendar scope is granted.

Why does fetching a feishu.cn URL return an ad or challenge page?

Feishu blocks plain HTTP fetchers with an anti-bot page, so generic web fetching returns garbage instead of document content. Route the link through lark-cli instead: docs +fetch for documents and wiki, sheets +read for spreadsheets, base +record-list for Bitable.

How do I fix 401 or LARK_USER_AUTH_REQUIRED errors with lark-cli?

Run lark-cli auth login --recommend to obtain the recommended scope set in one authorization flow. If a specific call needs an extra high-sensitivity scope, lark-cli prints the exact lark-cli auth login --scope command to rerun; do not use --domain.

Does lark-cli work on Windows PowerShell?

Yes, the lark-cli binary is cross-platform and works identically in PowerShell and bash. However, setup glue differs: on Windows use PowerShell recipes with ConvertFrom-Json and Join-Path, and avoid bash constructs like command -v, jq pipelines, and cat heredocs.

How do I install lark-cli for Feishu terminal access?

Install the official npm package globally with npm install -g @larksuite/cli, which provides the lark-cli binary. If the global install fails with a permission error, use a per-user prefix or an elevated install after telling the user.