Lark CLI Skill: Mail — Email Management

What it is

The Mail skill is one of 19 AI agent skills in the Lark CLI toolkit. It gives AI agents command-line access to Lark/Feishu email operations: sending emails, reading inbox messages, managing folders, searching mail, and handling attachments. Lark Mail is the built-in email client of the Lark platform, and this skill makes it programmable from the terminal or through AI agent workflows.

The skill targets teams that use Lark Mail for business communication and want to automate email-related tasks. AI agents can draft and send templated emails, process incoming messages, extract information from email threads, and trigger workflows based on email content, all without opening the email client.

How it saves time or tokens

Email-triggered workflows are common in business: a customer inquiry arrives, someone reads it, routes it to the right team, drafts a response, and follows up. The Mail skill lets AI agents handle the reading, routing, and drafting steps automatically. The agent reads new emails, classifies them by content, drafts appropriate responses, and queues them for human review or sends them directly.

For outbound email, the skill eliminates the manual effort of composing repetitive messages. Meeting follow-ups, report distributions, and notification emails can be generated from templates and sent in bulk through a single CLI command.

How to use

1. Install Lark CLI and skills:

```bash

npm install -g @larksuite/cli

npx skills add larksuite/cli -y -g

```

1. Authenticate:

```bash

lark-cli config init

lark-cli auth login --recommend

```

1. Send an email:

```bash

lark-cli mail +send \

--to 'recipient@company.com' \

--subject 'Weekly Report' \

--body 'Please find the attached report.'

```

Example

Email operations with the Lark CLI:

# Send an email with subject and body
lark-cli mail +send \
  --to 'team@company.com' \
  --subject 'Sprint 14 Summary' \
  --body 'All stories completed. Deployment scheduled for Friday.'

# List recent inbox messages
lark-cli mail +inbox --page-size 10

# Read a specific email
lark-cli mail +get --message-id 'msgXXXX'

# Search emails by keyword
lark-cli mail +search --query 'quarterly review'

Mail skill command summary:

Related on TokRepo

• AI Tools for Email — Browse AI-powered email tools and automation solutions.
• AI Tools for Automation — Explore automation tools for communication workflows.

Common pitfalls

• Not having the mail permission scope configured in your Lark app. Email operations require specific API permissions. If your app was created without mail scopes, all mail commands will return permission errors. Update your app's permissions in the Lark Open Platform console.
• Sending emails without proper formatting. The CLI sends plain text by default. For HTML-formatted emails, use the --html-body flag or pass HTML content through a content file. Plain text emails may lose formatting that recipients expect in business communication.
• Ignoring rate limits for bulk email sending. Lark enforces per-app sending limits to prevent spam. If you need to send to many recipients, batch your sends and include delays between groups to stay within the rate limits.