lark-contact

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

Updated Sep 13, 2026
One-click install
npx skills add https://github.com/U1traVeno/skills --skill lark-contact-u1traveno
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lark-contact
Source: https://github.com/U1traVeno/skills/tree/main/profiles/lark/lark-contact
Command: npx skills add https://github.com/U1traVeno/skills --skill lark-contact-u1traveno

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? When working with Feishu/Lark, you often need a user's open_id before you can send messages or schedule meetings, or you have an open_id and need to look up the person's name, department, email, or personal status. This Skill handles that identity resolution in both directions through the lark-cli contact commands. ## Core Features & Use Cases - Name/Email to open_id: Search employees by name, email, or phone keyword with filters like has-chatted, enterprise email, same-tenant, and employment status. - open_id to Profile: Reverse-lookup user details including name, department, email, activation status, personal status, and signature, with support for open_id, union_id, and user_id types. - Batch Operations: Fan out up to 20 parallel name queries or batch-validate up to 100 open_ids in one call. - Use Case: To message a colleague named Zhang San, first search to confirm the correct open_id among same-name candidates, then hand that open_id to the messaging skill. ## Quick Start Ask the assistant to find the open_id of a colleague by name using the Lark contact search, then look up their department and email.

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 lark-cli contact +search-user with the --query flag and the person's name, optionally adding --has-chatted to narrow results. The search returns open_id values you can pass to messaging or calendar commands.

How to look up Lark user details from an open_id?▼

Run lark-cli contact +search-user --user-ids <id> as a user identity, or +get-user --user-id <id> as a bot identity. The search-user path returns richer fields like department, email, and activation status.

Can I search multiple Lark contacts in one command?▼

Yes, use --queries with a comma-separated list of up to 20 names for parallel search, or --user-ids with up to 100 open_ids for batch field backfill. 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 between user and bot identity, or ask an administrator to adjust the contact visibility range.

What are the limitations of Lark contact search?▼

Search only works with user identity, not bot, and does not auto-paginate when has_more is true. Cross-tenant users return empty business fields, and the skill does not cover department trees or org charts.