skills.rest
CalWade
CalWadeCOMMUNITY
Explore all skills by this author →
GitHub

lark-contact

Resolves Lark contact names and emails to open_ids and retrieves user profiles.

Updated May 22, 2026
Search Tags:#directory#feishu#lark#lark-cli#user lookup#open_id#contact search
One-click install
npx skills add https://github.com/CalWade/aigc-creator --skill lark-contact-calwade
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lark-contact
Source: https://github.com/CalWade/aigc-creator/tree/main/.agents/skills/lark-contact
Command: npx skills add https://github.com/CalWade/aigc-creator --skill lark-contact-calwade

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires lark-cli, and includes references (resource) components.

What problem does it solve? When you want to message someone or schedule a meeting in Feishu/Lark, you first need their open_id, but you usually only know their name or email. This Skill resolves names and emails into open_ids, and reverse-looks up profiles (name, department, email, personal status, signature) from known open_ids. ## Core Features & Use Cases - Name/Email to open_id Resolution: Search employees by name, email, or phone keyword with filters like has-chatted, enterprise email, same-tenant, and employment status. - Profile Lookup: Retrieve user details by open_id, union_id, or user_id, with separate command paths for user identity and bot identity. - Batch Queries: Fan out up to 20 parallel name searches or batch-query personal status and signatures for multiple colleagues. - Use Case: You want to send a message to a colleague named Zhang San. Search by name, confirm the correct person from the candidates, get their open_id, then hand off to the messaging skill. ## Quick Start Ask the assistant to find Zhang San's open_id in Lark contacts so you can send him a message.

Frequently Asked Questions about lark-contact

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find a Lark user's open_id by name?▼

Use the contact search command with the person's name as the query, for example lark-cli contact +search-user --query "Zhang San" --has-chatted. If multiple people share the name, review the candidates and pick the right one before taking further action.

How to look up a Lark user profile from an open_id?▼

With bot identity, run lark-cli contact +get-user --user-id ou_xxx --as bot. With user identity, use +search-user --user-ids <id> instead, which returns richer fields like department, email, and activation status.

Can I search multiple Lark contacts at once?▼

Yes, the --queries flag accepts a comma-separated list of up to 20 keywords searched in parallel. Each result row carries a matched_query field, and partial failures do not affect other queries.

Why does Lark contact search return permission denied error 41050?▼

Error 41050 means the current identity's visibility scope does not cover the target user. Switch to bot identity or ask an administrator to adjust the visibility range, as both search and get-user commands are subject to these scope limits.

What are the limitations of Lark contact search?▼

Search is only available under user identity and does not auto-paginate; has_more=true means you should refine the query. Cross-tenant users often return empty business fields, and department tree traversal or org chart listing is out of scope and requires native OpenAPI.

Related Skills

Explore More Software Engineering Skills→
ZJU-REALZJU-REAL
195

lark-contact

Resolve employee names or emails to Lark open_id values and retrieve contact profiles.

Official
Advanced
U1traVenoU1traVeno

lark-contact

Resolves Lark contact names and emails to open_ids and retrieves user profiles.

Community
Intermediate
Rabbit-IvanRabbit-Ivan

lark-contact

Query Feishu organization structure, user profiles, and search employees via lark-cli.

Community
Basic
yjwongyjwong
53

contacts

Retrieve Lark directory employee data via lark CLI commands as JSON output.

Community
Basic