lark-contact

Resolves Lark contacts by name or email into open_ids and retrieves user profiles.

8|2|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/luojiaaoo/xpeech --skill lark-contact-luojiaaoo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lark-contact
Source: https://github.com/luojiaaoo/xpeech/tree/main/xpeech/agent/skills/buildin/lark-skills/lark-contact
Command: npx skills add https://github.com/luojiaaoo/xpeech --skill lark-contact-luojiaaoo

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? When working with Feishu/Lark messaging or scheduling, you often only know a person's name or email, but the APIs require an open_id. This Skill resolves names and emails into open_ids, looks up user profiles by ID, and searches for visible bots and agents, so downstream messaging and calendar actions can target the right identity. ## Core Features & Use Cases - User Search: Find employees by name, email, or phone keyword and obtain their open_id, with filters for chat history, enterprise email, tenant boundary, and employment status. - Profile Lookup: Retrieve user details by open_id, union_id, or user_id, including department, email, personal status, and signature. - Bot and Agent Search: Search bots and agents visible to the current user by keyword, returning bot open_ids for messaging or group invitations. - Use Case: To message a colleague named Zhang San, first search by name to confirm the correct open_id among same-name candidates, then hand the open_id to the messaging skill. ## Quick Start Ask the assistant to find the Feishu open_id of a colleague by name so you can send them 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 Feishu user's open_id by name?▼

Run lark-cli contact +search-user with the --query flag and the person's name or email under user identity. The command returns matching users with open_id, department, and email fields so you can confirm the right person before messaging.

How to search for Lark bots or agents by keyword?▼

Use lark-cli contact +search-bot with --query under user identity to search bots visible to the current user. It returns bot open_ids, descriptions, and an is_agent flag, and supports multiple keywords via --queries.

What is the difference between +search-user and +get-user in lark-cli?▼

+search-user works only under user identity and returns richer fields like department and email, while +get-user under bot identity fetches a user by ID. For user identity lookups of others, prefer +search-user --user-ids.

Why does lark-cli contact return permission denied error 41050?▼

Error 41050 means the current identity's visibility scope does not cover the target user or bot. This can occur on any contact command and depends on tenant visibility rules configured in Feishu.

Can lark-contact list employees by department or org chart?▼

No, department tree traversal and org chart listing are out of scope for this Skill. Those needs should use native OpenAPI endpoints through the lark-openapi-explorer skill instead.