lark-contact

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

Updated Jan 10, 2026
One-click install
npx skills add https://github.com/Rabbit-Ivan/Ivan-skills --skill lark-contact-rabbit-ivan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lark-contact
Source: https://github.com/Rabbit-Ivan/Ivan-skills/tree/main/skills/lark-contact
Command: npx skills add https://github.com/Rabbit-Ivan/Ivan-skills --skill lark-contact-rabbit-ivan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Looking up colleagues in Feishu (Lark) normally requires manual searching in the app or writing raw API calls against the contact endpoints. This Skill lets you retrieve user profiles, resolve open_ids, and search employees by name, email, or phone number directly from the command line. ## Core Features & Use Cases - User Info Retrieval: Get the current user's own profile or fetch a specific user's details by open_id, union_id, or user_id. - Employee Search: Search the organization directory by keyword (name, email, phone) with relevance-sorted results and pagination support. - Use Case: You need to send a message to a colleague but only know their name. Search for "张三" to get their open_id, then fetch their full profile including department and contact details. ## Quick Start Ask the AI to search Feishu contacts for a colleague named 张三 and show their detailed profile information.

Frequently Asked Questions about lark-contact

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

FAQPage Schema
How do I search for an employee in Feishu by name?▼

Run lark-cli contact +search-user with the --query flag followed by the name, email, or phone number. Results are sorted by relevance and returned as JSON by default, or use --format pretty for human-readable output.

How to get a user's open_id in Feishu contact API?▼

First search for the user with lark-cli contact +search-user to obtain their open_id from the JSON results. Then run lark-cli contact +get-user --user-id with that open_id to fetch the full profile.

Can I get my own Feishu user info from the command line?▼

Yes, run lark-cli contact +get-user without the --user-id flag. This calls the authen user_info endpoint and returns the currently authenticated user's profile.

Why does Feishu contact lookup return error 41050?▼

Error 41050 indicates insufficient permission, usually caused by organization structure visibility scope restrictions. Ask your administrator to expand the visible scope, or call the contact API using a tenant_access_token with app identity instead.

How do I paginate Feishu employee search results?▼

When the response shows has_more=true, pass the returned page_token with --page-token on the next request. You can also adjust --page-size up to 200, but paginating with tokens is the recommended approach.