lark-contact Skill for Claude: Look Up Lark and Feishu Contacts

Lets Claude find colleagues and bots in your Lark or Feishu directory by name or email, and read their profile, through lark-cli.

Installs: 472.1K; on skills.sh
Stars: 17.9K; on GitHub
Files: 3; besides SKILL.md
Updated: Oct 2026; last repo commit

lark-contact turns a name, email or phone into a Lark user ID, and a user ID back into a name, department and contact details. It also searches for bots and agents you can see. Claude uses it before sending messages or booking meetings, so it picks the right person.

It has three commands. User and bot identities take separate paths: searching people and bots works only as your user, and reading a profile by ID also works as the bot. If a search returns several matches and the next step has side effects, SKILL.md tells Claude to list them and let you pick. It needs lark-cli and a signed-in account.

Good for

Anyone who tells Claude "message Zhang San" and needs the right person found first
People who schedule meetings or add wiki members and need an exact user ID
Developers building Lark flows that start from a name

Install lark-contact

Claude Code

Copy this prompt.

Install the lark-contact skill in Claude Code. Run this command:

npx @larksuite/cli@latest install

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

This skill only gives Claude instructions for the lark-cli command line, so install the CLI first, then the skills, then sign in. The skills command adds the whole larksuite/cli set, which includes lark-shared, the skill this one reads first for sign-in and permissions.

From the project README. Source.

What's in the skill

When it loads

飞书 / Lark 通讯录:按姓名 / 邮箱解析成 open_id,或按 open_id 反查姓名 / 部门 / 邮箱 / 联系方式 / 个人状态 / 签名,以及按关键词搜索当前用户可见的机器人 / 智能体(agent)。当用户提到一个名字要下一步发消息 / 排日程,或拿到 open_id 想查具体信息时使用。不负责部门树遍历、按部门列员工、组织架构图,这类需求走原生 OpenAPI。

Sections in SKILL.md

选哪个命令
名字没说清是人还是机器人 / 智能体
典型场景
搜索机器人 / 智能体
注意事项
不在本 skill 范围

Key facts

Author: Lark Suite (larksuite)
Repository: larksuite/cli, folder skills/lark-contact
Installs on skills.sh: 472,129 as of 2026-11-02
GitHub stars: 17,911 for the whole larksuite/cli repo, 2026-11-02
License: MIT
Last repo commit: 2026-10-30
What is inside: 3 bundled reference pages besides SKILL.md; no scripts
skills.sh audits: Gen Agent Trust Hub: pass, Socket: pass, Snyk: pass

What it includes

Finds people by name, email or phone
Returns the open_id other commands need; can limit to people you have chatted with.
Try: “Find Zhang San in the directory.”
Network · +search-user
Searches bots and agents you can see
User identity only; returns the bot open_id.
Network · +search-bot
Reads a profile by user ID
As the bot it reads another person by user ID. As your user it shows your own profile.
Network · +get-user
Reads status and signature for many colleagues
A raw API call; SKILL.md says to check its schema first.
Network · user_profiles batch_query

From the official docs

Permissions

Low risk

The skill reads your company directory, so staff names and contact details end up in the conversation. Search only for people you need.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It acts as you in Lark after you sign in
The repo README warns that the agent works under your user identity within the authorized scope. Grant only the scopes you need and read commands before you approve them. github.com
Directory details go into the chat
Names, emails and phone numbers that Claude reads are sent to your AI provider. Search only for people you need. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	The skill has no read-only switch. Sign in with a narrow scope list, for example lark-cli auth login --domain <name>, so the agent cannot reach more than you intend.
Talks to	Lark/Feishu Open Platform API calls made by lark-cli. Your AI provider receives whatever Claude reads from Lark
Sign-in and keys	lark-cli stores credentials in the OS keychain, per the repo README.
Scopes	Claude runs lark-cli commands in your terminal After you sign in, commands run as your Lark or Feishu user within the permissions you granted Reads names, departments, emails and contact details of people you can see

Questions

How do I install lark-contact?

Use the install box at the top of this page. The box lists three steps: install the Lark CLI, add the Lark skills, then set up an app and sign in. The skill is only instructions, so Claude cannot use it until lark-cli is installed and you are signed in.

Do I need a Lark account to use lark-contact?

Yes. You need a Lark or Feishu account, plus an app set up with lark-cli config init. The README then has you sign in with lark-cli auth login --recommend. There is no separate API key to paste.

Does lark-contact send messages or book meetings?

No. It only finds people and profiles. SKILL.md hands messaging to lark-im and scheduling to lark-calendar, and org-chart questions to lark-openapi-explorer.

Why does a search return empty fields or a permission error?

Results depend on what your identity can see. SKILL.md says a 41050 permission error comes from visibility limits, and people from other tenants return mostly empty business fields.

Is lark-contact safe?

Use it with care. It only reads directory data, but that includes names, emails and contact details. The repo README warns that after you authorize Lark permissions the agent acts under your user identity and that model mistakes or prompt injection can cause real changes.

Information

updated Nov 2, 2026

Repository: larksuite/cli
Folder: skills/lark-contact

larksuite/cli skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 3

larksuite/cli README · github.com
lark-contact SKILL.md · github.com
lark-skill-maker SKILL.md · github.com