lark-contact

Installation
Summary

Lark directory lookup to convert employee names and emails to open_ids, and reverse-lookup employee details by ID.

  • Two independent command paths for user and bot identities: search by name/email for open_id (user only), or fetch employee details by open_id (both identities)
  • Handles permission scoping, cross-tenant visibility rules, and multiple ID types (open_id, union_id, user_id)
  • Integrates with lark-im and lark-calendar for downstream messaging, scheduling, and group operations after ID resolution
SKILL.md

contact (v2)

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md,其中包含认证、权限处理

选哪个命令

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

想做什么 user 身份 bot 身份
按姓名 / 邮箱搜员工拿 open_id +search-user 不支持
已知 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

典型场景

Installs
277.8K
Repository
larksuite/cli
GitHub Stars
14.8K
First Seen
Mar 28, 2026
lark-contact — larksuite/cli