Lark Contact

This integrates with Lark/Feishu's contact directory to pull employee info and org charts. You can search for colleagues by name, email, or phone number, grab someone's open_id for other integrations, or get detailed user profiles including department structure. It's built around two main operations: searching users with relevance-ranked results and fetching specific user details. Handles the Lark API authentication automatically through lark-cli. Most useful when you're building workflows that need to look up team members, validate employee data, or integrate with other Lark services that require user identifiers.

skills.sh installs: 478.2K
GitHub stars: 18K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add larksuite/cli --skill lark-contact --agent claude-code

Installs into .claude/skills of the current project.

Files

选哪个命令

user 身份和 bot 身份是两条完全独立的路径。先确定当前身份,再按下表选命令:

想做什么	user 身份	bot 身份
按姓名 / 邮箱搜员工拿 open_id	`+search-user`	不支持
按关键词搜索当前用户可见的机器人 / 智能体	`+search-bot`	不支持
已知 open_id 取他人资料	`+search-user --user-ids <id>`	`+get-user --user-id <id>`
查看自己	`+get-user` 或 `+search-user --user-ids me`	不支持
查同事的个人状态 / 签名	`user_profiles batch_query`	不支持

已知 open_id 只是想发消息 / 排日程,不必经过 contact —— 直接 lark-im / lark-calendar。

名字没说清是人还是机器人 / 智能体

用户给的名字常常不表明类型。例如「和 reviewDuck 约个会」里的 reviewDuck 可能是同事昵称,也可能是机器人。

名字含 bot / agent / AI / 助手 / 机器人 / 智能体 / assistant 等明显特征时,反过来先搜机器人更快
不确定的话两边都搜一下

典型场景

找张三给他发消息:先搜,确认 open_id,再发:

lark-cli contact +search-user --query "张三" --has-chatted --as user
lark-cli im +messages-send --user-id ou_xxx --text "Hi!"

批量查同事的个人状态 / 个性签名(先用 schema 看参数)。

SKILL.md on GitHub

Details

Repository: github.com/larksuite/cli
Categories: AI & Agent Building, CLI & Terminal, Office & Documents
First seen: Apr 16, 2026