contacts

Contacts Lookup Skill

Look up employee information via the lark CLI.

Running Commands

Ensure lark is in your PATH, or use the full path to the binary. Set the config directory if not using the default:

lark contact <command>
# Or with explicit config:
LARK_CONFIG_DIR=/path/to/.lark lark contact <command>

Commands Reference

Get User by ID

# Look up by open_id (default)
lark contact get ou_xxxx

# Look up by user_id
lark contact get 12345 --id-type user_id

Output:

{
  "user_id": "ou_xxx",
  "open_id": "ou_xxx",
  "name": "Jane Doe",
  "en_name": "Jane Doe",
  "email": "[email protected]",
  "job_title": "Data Analyst",
  "department": "Business Intelligence"
}

List Users in Department

# List users in root department
lark contact list-dept

# List users in specific department
lark contact list-dept od_xxxx

Output:

{
  "contacts": [
    {
      "user_id": "ou_xxx",
      "name": "Alice",
      "job_title": "Engineer",
      "department": "Engineering"
    }
  ],
  "count": 1
}

Search Users by Name

lark contact search "Jane"
lark contact search "John Smith"

Output:

{
  "contacts": [
    {
      "user_id": "ou_xxx",
      "open_id": "ou_xxx",
      "name": "Jane Doe",
      "department": "Engineering"
    }
  ],
  "count": 1
}

Search Departments

lark contact search-dept "Engineering"

Output:

{
  "departments": [
    {
      "department_id": "od_xxx",
      "name": "Engineering",
      "member_count": 42
    }
  ],
  "count": 1
}

Integration with Calendar

When showing calendar events with attendees, you can enrich attendee info:

1. Get attendee open_id from calendar event
2. Use contact get <open_id> to fetch job title and department
3. Present enriched attendee info to user

Example workflow:

# Get event with attendees
lark cal show <event_id>
# Returns attendees with open_id

# Look up each attendee
lark contact get ou_attendee_id
# Returns name, job_title, department