Lark Contact

contact (v2)

选哪个工具

user 身份和 bot 身份是两条完全独立的路径。MCP server 始终使用 user 身份，按下表选工具:

| 想做什么 | user 身份 | bot 身份 | |---|---|---| | 按姓名 / 邮箱搜员工拿 openid | lark_contact_search_user (参见 lark_get_skill(domain="contact", section="search-user")) | 不支持 | | 已知 openid 取他人资料 | lark_contact_search_user(user_ids="") | ⚠️ 需要 bot 身份，MCP server 不可用 | | 查看自己 | lark_contact_get_user() 或 lark_contact_search_user(user_ids="me") | 不支持 | | 查同事的个人状态 / 签名 | 通过 lark_invoke 调用 lark_contact_user_profiles_batch_query | 不支持 |

已知 open_id 只是想发消息 / 排日程,不必经过 contact —— 直接用 lark_get_skill(domain="im") / lark_get_skill(domain="calendar")。

典型场景

找张三给他发消息:先搜,确认 open_id,再发:

lark_contact_search_user(query="张三", has_chatted=true)
lark_im_messages_send(user_id="ou_xxx", text="Hi!")

批量查同事的个人状态 / 个性签名(先用 lark_discover 看参数)。

lark_discover(query="contact.user_profiles.batch_query")
lark_invoke(tool_name="lark_contact_user_profiles_batch_query", args={
  params: {"user_id_type": "open_id"},
  data: {"user_ids": ["ou_xxx", "ou_yyy"], "query_option": {"include_personal_status": true, "include_description": true}}
})

搜索命中多条且后续操作有副作用(发消息、邀请会议等),把候选列给用户挑;不要擅自选第一条。

注意事项

• 41050 / Permission denied 受当前身份的可见范围限制(两条工具都可能遇到)。需要管理员调整可见范围。
• 跨租户用户(is_cross_tenant=true)多数业务字段为空字符串,这是飞书可见性规则,下游做空值兜底。
• ID 类型:默认 open_id。lark_contact_get_user 可用 user_id_type="union_id" 或 "user_id"；lark_contact_search_user 只接受 open_id。

不在本 skill 范围

• 发消息 / 查聊天记录 → lark_get_skill(domain="im")
• 排日程 / 邀请会议 → lark_get_skill(domain="calendar")
• 部门树 / 按部门列员工 / 组织架构 → lark_get_skill(domain="openapi-explorer") 查找原生接口

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: ddpie
• Source: ddpie/lark-mcp-on-agentcore
• License: MIT

Install and usage instructions live in the source repository linked above.