email

email is a skill for Claude Code, Codex from yjwong/lark-cli. It costs 29 tokens per session (1,344 once invoked), scanned A, original, MIT.

A tool for reading and searching Lark Mail, an email service, through IMAP, the standard protocol used by mail applications. It keeps a local cache of messages and mailboxes.

In plain words
What is it for?
Use it to check mail connection status, list mailboxes, sync the inbox or another mailbox, and search cached email.
Why use it?
It lets an agent find and review email without repeatedly downloading the same messages, while showing whether the cached data is up to date.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/yjwong/lark-cli/email
Any agent
npx skills add yjwong/lark-cli --skill email
Clone the repo
git clone --depth 1 https://github.com/yjwong/lark-cli

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for email

README.md
[![agentmods](https://agentmods.dev/badge/skills/yjwong/lark-cli/email.svg)](https://agentmods.dev/skills/yjwong/lark-cli/email)
Your own site
<a href="https://agentmods.dev/skills/yjwong/lark-cli/email"><img src="https://agentmods.dev/badge/skills/yjwong/lark-cli/email.svg" alt="Measured on agentmods" height="20"></a>
Per session 29 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,344 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00029 $0.01344
Opus 5 $0.00015 $0.00672
Sonnet 5 $0.00006 $0.00269
Haiku 4.5 $0.00003 $0.00134

Measured 3d ago against content hash 1df026e6fa07, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

email scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/email/SKILL.md · 228 lines

How it starts

The opening of the file, as written. The whole thing — 228 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Email Management Skill

Read and search emails from Lark Mail via the lark CLI using IMAP with local caching.

Setup

Before using mail commands, IMAP credentials must be configured:

lark mail setup

This will prompt for IMAP credentials. See: https://www.larksuite.com/hc/en-US/articles/378111206512-log-in-to-lark-mail-through-a-third-party-email-client

Running Commands

Ensure lark is in your PATH, or use the full path to the binary. Set the config directory if not using the default:

lark mail <command>
# Or with explicit config:
LARK_CONFIG_DIR=/path/to/.lark lark mail <command>

Commands Reference

Check Status

lark mail status

Shows connection status and cache freshness. The freshness field indicates how stale the cached data is.

List Mailboxes

lark mail list

Sync Emails

Fetch new emails from the server into the local cache:

# Sync INBOX (default)
lark mail sync

# Sync with more parallel connections (faster for large mailboxes)
lark mail sync --workers 20

# Sync specific mailbox
lark mail sync --mailbox Sent

Flags:

  • --mailbox, -m: Mailbox to sync (default: INBOX)
  • --workers, -w: Number of parallel connections (default: 10)

Important:

  • Run sync before searching if you need fresh data
  • Sync is resumable - if interrupted, running it again only fetches messages not already cached

Search Emails

Search the local cache (fast, no network calls):

# List recent emails
lark mail search

# Filter by sender
lark mail search --from [email protected]

# Filter by subject
lark mail search --subject "Q4 Report"

# Filter by date range
lark mail search --since 2025-01-01 --before 2025-01-15

# Combined filters
lark mail search --from [email protected] --since 2025-01-01 --limit 10

# Search different mailbox
lark mail search --mailbox Sent

View Email Content

lark mail show --uid <uid>

The UID is obtained from search results.

Download as .eml

lark mail fetch --uid <uid>
lark mail fetch --uid <uid> --output ./emails/

Read the full file on GitHub · 228 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 228 lines · 29 tokens per session scan A 1df026e6fa07

Subscribe to this mod's changes

email is a skill published in the GitHub repository yjwong/lark-cli (53 stars, last pushed 5mo ago), licensed MIT. It adds 29 tokens to every session and 1,344 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

lark-cli

Lark/Feishu workspace operations through the lark-cli tool — calendar and meeting rooms, docs, sheets, Base (多维表格), wiki, drive, mail, IM messages, tasks, OKR, approvals, minutes, video conferences, whiteboards, slides, contacts, attendance, and real-time events. Use whenever the user mentions 飞书 / Lark / 我的日程 / 约会议 /…

vaayne/agent-kit · 200 tokens

lark-drive

飞书云空间(云盘/云存储):管理 Drive 文件和文件夹,包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、评论/权限/订阅、标题、版本和本地文件导入。用户需要整理云盘目录、处理云空间资源 URL/token、判断链接类型/真实 token/标题,或导入 Word/Markdown/Excel/CSV/PPTX/.base 为 docx/sheet/bitable/slides 时使用;doubao.com 云空间 URL/token 也按资源路径和 token 路由,不回退 WebFetch。不负责:文档内容编辑(走 lark-doc)、表格/Base 表内数据操作(走…

ddpie/lark-mcp-on-agentcore · 192 tokens

lark-im

飞书即时通讯:收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件(支持大文件分片下载)、管理表情回复、发送应用内/短信/电话加急、发送和处理交互卡片(Interactive Card)、监听卡片按钮回调(card.action.trigger)。当用户需要发消息、查看或搜索聊天记录、下载聊天中的文件、查看群成员、搜索群、创建群聊或话题群、管理标记数据、管理 Feed 置顶(添加/移除/查询置顶会话)、管理标签数据、处理卡片回调时使用。.

ddpie/lark-mcp-on-agentcore · 147 tokens

lark-vc-agent

飞书视频会议会中能力:发现当前用户正在进行中的会议并读取当前身份可见的会中事件,如参会人加入/离开、发言、聊天、屏幕共享,也可向进行中的会议发送会中文本消息或会中表情。适用于用户询问正在开的会议发生了什么、谁在发言、是否共享内容、想在会里发一句话或发反馈,或需要发现当前可读的进行中会议 ID(larkvcmeetinglistactive)。读取事件用 larkvcmeetingevents,发送会中文本或表情用 larkvcmeetingmessagesend。不负责已结束会议搜索、参会人快照、纪要、逐字稿或录制查询,这些使用 lark-vc 技能。.

ddpie/lark-mcp-on-agentcore · 178 tokens

lark-vc

飞书视频会议:搜索历史会议记录、查询会议纪要(总结/待办/章节/逐字稿)、查询参会人快照。当用户查询已结束的会议、获取会议产物(纪要/妙记)、查看参会人时使用;查询未来日程走 lark-calendar。不负责:Agent 真实入会/离会、会中实时事件(走 lark-vc-agent)。.

ddpie/lark-mcp-on-agentcore · 95 tokens

lark-calendar

飞书日历:管理日历日程和会议室。查看/搜索日程、创建/更新日程、管理参会人、查询忙闲和推荐时段、预定会议室。当用户需要查看日程安排、创建/修改会议、查询/预定会议室时使用。不负责:查询过去的视频会议记录(走 lark-vc)、待办任务(走 lark-task)。.

ddpie/lark-mcp-on-agentcore · 92 tokens