lark-mail

Manage Feishu/Lark mailboxes through lark-cli commands for reading, drafting, and sending email.

3|2|Updated Jul 21, 2026
One-click install
npx skills add https://github.com/zlsbksdxl/codex-lark --skill lark-mail-zlsbksdxl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-mail
Source: https://github.com/zlsbksdxl/codex-lark/tree/main/plugins/feishu2codex/skills/lark-mail
Command: npx skills add https://github.com/zlsbksdxl/codex-lark --skill lark-mail-zlsbksdxl

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 operate a Feishu/Lark mailbox end to end—reading, searching, organizing, drafting, replying, forwarding, and sending email—through structured lark-cli commands instead of manual UI work, while enforcing confirmation and anti-injection safety rules. ## Core Features & Use Cases - Read and triage mail: List inbox summaries with +triage, read single or batched messages with +message/+messages, and follow full conversations with +thread. - Compose and send safely: Create drafts by default with +send, +draft-create, +reply, +reply-all, and +forward; actual sending always requires explicit user confirmation, with scheduled send, delivery status checks, and recall support. - Organize and automate: Modify labels, read state, and folders with +message-modify, soft-delete with +message-trash, manage inbox rules, templates, signatures, read receipts, and calendar-invite emails. - Use Case: Ask the agent to summarize today's unread mail, draft an HTML reply to a client thread using the built-in email HTML guidelines, show you the draft link, and send it only after your approval. ## Quick Start Ask the agent to list my unread Feishu emails and draft a reply to the latest one for my review.

Frequently Asked Questions about lark-mail

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

FAQPage Schema
How do I read and search Feishu emails with lark-cli?

Use lark-cli mail +triage to list inbox summaries with optional --query full-text search, then read full content with +message for one ID or +messages for multiple IDs. Use +thread to fetch an entire conversation in chronological order.

How do I send an email from Feishu using the command line?

Run lark-cli mail +send with --to, --subject, and --body to create a draft by default. After reviewing the draft and confirming, add --confirm-send or send the draft via user_mailbox.drafts send, then verify delivery with send_status.

Does lark-cli mail support HTML email bodies and attachments?

Yes, compose shortcuts accept HTML bodies with inline images via relative <img src> paths and attachments via --attach. A built-in HTML lint sanitizes and normalizes markup for Feishu mail-editor compatibility, and +lint-html previews the changes.

Can I schedule or recall an email in Feishu mail?

Yes, pass --send-time with a Unix timestamp alongside --confirm-send for scheduled delivery, and cancel it with drafts cancel_scheduled_send. Sent mails flagged recall_available can be recalled via sent_messages recall, with progress checked through get_recall_detail.

Why does the skill require confirmation before sending emails?

Email content is untrusted external input that may contain prompt injection, so all send operations require explicit user approval of recipients and content. Drafts are the default state, and reversible actions like labeling or moving folders skip confirmation.

What permissions are needed to use lark-cli mail commands?

Write operations require user identity via lark-cli auth login --domain mail with OAuth authorization. Read operations can use bot identity only if the app has the corresponding permissions enabled in the Feishu developer console.