Lark CLI Skill: Contact — User & Org Directory

What it is

This Lark CLI skill provides programmatic access to the Lark/Feishu contact and organizational directory. It lets you search users by name, email, or phone number, retrieve detailed user profiles, and query the organizational structure including departments and reporting hierarchies.

The skill targets developers and automation engineers who need to look up user information or org data from Lark/Feishu without navigating the web interface.

How it saves time or tokens

Manual user lookup in Lark requires logging into the admin console and navigating multiple screens. This CLI skill provides instant access to the same data with a single command. For AI agents managing team workflows, the skill provides the user IDs needed to assign tasks, send messages, or create calendar events.

Batch lookups across departments are especially efficient compared to manual search.

How to use

1. Configure the Lark CLI with your app credentials (App ID and App Secret)
2. Use the contact search command to find users by name, email, or phone
3. Use the profile command to get detailed user information
4. Use the org command to query department hierarchies

Example

# Search for a user by name
lark contact search --name 'Alice Wang'

# Get user profile by user ID
lark contact get --user-id 'ou_abc123'

# List all users in a department
lark contact list --department-id 'od_dept001'

# Query org structure
lark contact org --department-id 'od_root' --recursive

The output includes user IDs, names, emails, phone numbers, departments, and job titles in JSON format.

Related on TokRepo

• Automation tools -- Workflow automation with APIs
• API tools -- API integration and management

Common pitfalls

• Contact API access requires the app to have 'contact:user.employee:readonly' scope; missing permissions return empty results
• User IDs differ between open_id, union_id, and user_id formats; use the correct format for downstream API calls
• Rate limits apply to batch queries; add delays when iterating over large departments