lark-mail

Compose, send, read, and manage Feishu Mail messages via the lark-cli command line.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Managing a Feishu (Lark) mailbox from an AI agent or terminal requires navigating dozens of raw API endpoints, MIME structures, and permission scopes. This Skill wraps the Feishu Mail API into safe, high-level shortcuts so you can draft, send, reply, forward, search, and organize email without memorizing API schemas. ## Core Features & Use Cases - Compose and send safely: Create drafts by default with +send, +reply, +reply-all, and +forward; actual sending always requires explicit user confirmation, with support for scheduled sending, delivery status checks, and message recall. - Read and triage efficiently: Use +triage to list inbox summaries with filters and full-text search, +message/+messages/+thread to read normalized plain-text or HTML bodies, and +watch to monitor incoming mail events in real time. - Full mailbox administration: Manage drafts, folders, labels, contacts, attachments, signatures, aliases (send_as), shared mailboxes, and inbound mail rules through documented native API resources. - Use Case: Ask the agent to "reply to the latest email from my manager saying the report is done" — it finds the message, creates a reply draft preserving the quoted thread, shows you a summary, and sends only after your confirmation. ## Quick Start Ask the assistant to list your unread inbox emails or draft a reply to a specific message, and it will use lark-cli mail shortcuts to do it after confirming your identity.

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?

Run lark-cli mail +send with --to, --subject, and --body to create a draft, then confirm with the user and send it via lark-cli mail user_mailbox.drafts send. The --confirm-send flag sends immediately but only after explicit user approval.

How do I search and read emails in Feishu Mail from the command line?

Use lark-cli mail +triage with --query for full-text search or --filter for exact conditions like folder, sender, or unread status. Then read full content with +message, +messages, or +thread using the returned message_id or thread_id.

Does lark-cli mail support scheduled sending and recall?

Yes. Add --send-time with a Unix timestamp alongside --confirm-send for scheduled delivery, cancel it with drafts cancel_scheduled_send, and recall delivered messages within 24 hours using user_mailbox.sent_messages recall.

Why does lark-cli mail save drafts instead of sending directly?

All compose shortcuts default to draft mode as a safety measure so the user can review recipients, subject, and body before anything is sent. Sending requires explicit user confirmation, either via --confirm-send or the drafts send API.

Can I send email from a shared mailbox or alias address?

Yes. Query available mailboxes with user_mailboxes accessible_mailboxes and sender addresses with user_mailbox.settings send_as, then pass --mailbox for the shared mailbox and --from for the alias in any compose shortcut.

What permissions does lark-cli mail require?

Read operations need scopes like mail:user_mailbox.message:readonly, while all write operations (send, reply, draft edits) require user identity with scopes such as mail:user_mailbox.message:send or :modify. Real-time watching additionally needs mail:event and the message_received event subscription.