feishu-cli-mail

Manage Feishu mailbox operations including triage, drafts, replies, and HTML email sending.

1.4k|142|Updated Jan 21, 2026
One-click install
npx skills add https://github.com/riba2534/feishu-cli --skill feishu-cli-mail
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: feishu-cli-mail
Source: https://github.com/riba2534/feishu-cli/tree/main/skills/feishu-cli-mail
Command: npx skills add https://github.com/riba2534/feishu-cli --skill feishu-cli-mail

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Handling Feishu email through an AI agent requires careful control over reading, drafting, and sending so that no message is sent prematurely and no sensitive content leaks. This Skill provides a safe, structured workflow for Feishu mailbox operations with draft-first sending and explicit confirmation gates.

Core Features & Use Cases

  • Inbox Triage and Reading: List unread mail, search by query/folder/label, fetch single messages, batch messages, and full threads with sender context.
  • Draft-First Sending: mail send saves a draft by default; real sending only happens with explicit --confirm-send after verifying recipients, subject, and attachments.
  • Replies, Forwards, and HTML Mail: Automatic Re:/Fwd: prefixes, quoted blocks, In-Reply-To threading, HTML body auto-detection, and CID inline image upload for rich emails.
  • Use Case: Ask the agent to triage unread inbox messages, summarize an email thread, draft a weekly report email with inline charts, review the draft, and only send after your explicit confirmation.

Quick Start

Ask the agent to list your unread Feishu inbox messages and draft a reply to one of them without sending it.

Frequently Asked Questions about feishu-cli-mail

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

FAQPage Schema
How do I send an email with feishu-cli without sending it immediately?

Run feishu-cli mail send with --to, --subject, and --body; it saves a draft by default. The email is only actually sent when you explicitly add the --confirm-send flag after verifying recipients, subject, and content.

How do I read unread Feishu inbox messages from the command line?

Use feishu-cli mail triage --unread-only to list unread inbox messages, then fetch full content with mail message --message-id or an entire conversation with mail thread --thread-id. These read commands support bot or user identity via --as.

Does feishu-cli mail support HTML emails and inline images?

Yes, send, draft, and reply commands support HTML bodies with automatic detection of common tags or explicit --html. The mail send command also supports --inline-images-auto-scan to upload local images and rewrite them as CID references.

What permissions are required for feishu-cli mail commands?

All mail commands require a User Access Token obtained via feishu-cli auth login. Read commands need mail:user_mailbox readonly scopes, while send, reply, and draft operations additionally require message:modify and message:send scopes, verifiable with auth check.

What are the limitations of feishu-cli mail attachments and forwarding?

Regular file attachments are not yet supported on any send command. Forward currently supports plain-text bodies only, and CID inline image auto-scan works only with mail send, not with drafts, replies, or forwards.