lark-contact

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

1.3k|142|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/MiniMax-AI/minimax-code --skill lark-contact-minimax-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-contact
Source: https://github.com/MiniMax-AI/minimax-code/tree/main/packages/local-runtime/assets/skills/lark-tools/cli-skills/lark-contact
Command: npx skills add https://github.com/MiniMax-AI/minimax-code --skill lark-contact-minimax-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Finding colleague contact details, open_ids, or organizational structure in Feishu (Lark) normally requires manual searching in the app or writing raw API calls. This Skill lets you query the Feishu contact directory directly from the terminal using lark-cli shortcuts. ## Core Features & Use Cases - Employee Search: Search users by name, email, or phone number with relevance-sorted results and pagination support via lark-cli contact +search-user. - User Info Retrieval: Get the current user's profile or fetch a specific user's details by open_id, union_id, or user_id via lark-cli contact +get-user. - Use Case: You need a colleague's open_id to send them a message through the Feishu API. Search for them by name, parse the JSON output for their open_id, then retrieve their full profile. ## Quick Start Ask the AI to search Feishu contacts for a colleague named Zhang San and return their open_id and contact details.

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 employees in Feishu from the command line?

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

How to get a user's open_id in Feishu using lark-cli?

First search for the user with lark-cli contact +search-user --query "name" and parse the open_id from the JSON output. Then run lark-cli contact +get-user --user-id ou_xxx to retrieve their full profile.

Can I get my own Feishu user info without a user ID?

Yes. Run lark-cli contact +get-user without the --user-id flag to fetch the current authenticated user's information via the authen/v1/user_info endpoint.

Why does Feishu contact search return error 41050?

Error 41050 indicates insufficient permission, usually caused by organizational visibility scope restrictions on the current user. Ask an administrator to adjust the visibility range, or call the contact API using a tenant_access_token with app identity instead.

How do I paginate through Feishu employee search results?

When the response contains has_more=true, pass the returned page_token with --page-token on the next request. Avoid blindly increasing --page-size beyond the default 20; the maximum is 200.