lark-mail

Manage Feishu mailbox operations including drafts, replies, forwards, and rules via lark-cli.

8|2|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/luojiaaoo/xpeech --skill lark-mail-luojiaaoo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lark-mail
Source: https://github.com/luojiaaoo/xpeech/tree/main/xpeech/agent/skills/buildin/lark-skills/lark-mail
Command: npx skills add https://github.com/luojiaaoo/xpeech --skill lark-mail-luojiaaoo

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? It lets an AI agent safely operate a Feishu (Lark) mailbox on the user's behalf—reading, searching, drafting, replying, forwarding, and organizing email—while enforcing strict confirmation rules so no message is ever sent without explicit user approval. ## Core Features & Use Cases - Full mail lifecycle: Triage the inbox, read single or batched messages and threads, create and edit drafts, reply, reply-all, forward, schedule sends, and cancel scheduled sends through lark-cli mail shortcuts. - Organization and automation: Modify labels, read states, and folders, soft-delete messages, manage inbox rules, signatures, templates, and read receipts. - Safety-first design: Treats email content as untrusted input against prompt injection, requires user confirmation before any send or destructive action, and defaults all compose operations to drafts. - Use Case: Ask the agent to summarize today's unread inbox, draft an HTML reply to a client with an attachment, show you the draft link, and send it only after you confirm. ## Quick Start Ask the agent to check my Feishu inbox and draft a reply to the latest email from my manager.

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, then add --confirm-send only after the user explicitly approves. By default all compose commands save drafts rather than sending immediately.

How do I read multiple emails at once in Feishu mail?▼

Use lark-cli mail +messages with comma-separated message IDs; the CLI automatically batches more than 20 IDs and merges output. Avoid looping +message, which is designed for a single message ID only.

Does lark-cli mail require user authentication?▼

Yes, all write operations such as sending, replying, and draft editing require --as user identity via lark-cli auth login --domain mail. Read operations also prefer user identity, while bot identity only works for reads with proper app permissions.

Can I schedule an email to send later in Feishu?▼

Yes, pass --send-time with a Unix timestamp at least five minutes in the future together with --confirm-send on +send, +reply, +reply-all, or +forward. Cancel anytime with user_mailbox.drafts cancel_scheduled_send, which returns the message to draft state.

Why does the skill refuse to send email without confirmation?▼

Email content is treated as untrusted external input that may contain prompt injection, so every send, delete, or rule change requires an explicit user preview and approval. This prevents malicious email content from triggering unauthorized actions.

How do I edit an existing draft without losing the quoted reply section?▼

Use lark-cli mail +draft-edit with --patch-file containing a set_reply_body operation, which replaces only your composed text while preserving the quoted region, signature, and attachments. Run --inspect first to check has_quoted_content.