lark-mail

Compose, send, reply, forward, and search Feishu emails via lark-cli commands.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill lark-mail-yuezhen-huang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-mail
Source: https://github.com/yuezhen-huang/my-bytedance-skillhub/tree/main/lark-mail
Command: npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill lark-mail-yuezhen-huang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires lark-cli, and includes references (resource) components.

What problem does it solve? Managing Feishu (Lark) mailbox operations manually is slow and error-prone. This Skill lets an AI agent draft, send, reply to, forward, read, and search emails through lark-cli, while enforcing strict safety rules so no email is ever sent without explicit user confirmation. ## Core Features & Use Cases - Full email lifecycle: Compose new emails, reply, reply-all, and forward with automatic subject prefixes, recipient aggregation, and RFC 2822 threading headers. All send-type commands save as drafts by default and require --confirm-send after user approval. - Reading and triage: Browse inbox summaries with +triage, read single messages with +message, batch-read with +messages, and follow full conversations with +thread, with optional HTML or plain-text bodies to control token usage. - Mailbox management: Create and edit drafts (including MIME-level patch edits preserving quoted content), manage folders, labels, contacts, download attachments, watch for new mail via WebSocket, and verify delivery status after sending. - Use Case: Ask the agent to summarize today's unread inbox, draft an HTML reply to your manager's report email with an attached PDF, review the draft, then confirm sending and check delivery status. ## Quick Start Ask the agent to list my unread Feishu inbox emails and draft a reply to the latest one for my review before sending.

Frequently Asked Questions about lark-mail

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

FAQPage Schema
How do I send an email with lark-cli mail?

Use lark-cli mail +send with --to, --subject, and --body to create a draft first. After the user confirms the recipients and content, send it with lark-cli mail user_mailbox.drafts send, or add --confirm-send only after explicit approval.

How do I reply to a Feishu email and keep the thread?

Use lark-cli mail +reply with the message ID. It automatically sets the Re: subject, the original sender as recipient, and RFC 2822 In-Reply-To and References headers so the reply stays in the same conversation thread.

Does lark-cli mail send emails immediately by default?

No. All send-type shortcuts (+send, +reply, +reply-all, +forward) save a draft by default and return a draft_id. Actual sending requires the --confirm-send flag or the drafts send API, and only after explicit user confirmation.

How do I search or filter my Feishu inbox?

Use lark-cli mail +triage with --query for full-text search or --filter for exact conditions like folder, label, sender, subject, unread status, attachments, and time range. It returns message summaries with IDs for follow-up reads.

How do I edit a reply draft without losing the quoted content?

Use lark-cli mail +draft-edit with --patch-file and the set_reply_body op. It replaces only your written portion and automatically re-appends the quoted original message. Run --inspect first to confirm has_quoted_content is true.

Can lark-cli mail watch for new incoming emails in real time?

Yes. lark-cli mail +watch subscribes to the mail.user_mailbox.event.message_received_v1 event over WebSocket. It requires the mail:event scope and bot event subscription, and supports folder and label filters plus multiple output formats.