Lark

Feishu / Lark Comprehensive 技能

Prerequisite: You must have the official Lark MCP server 运行ning before using this 技能. 设置up: npx -y @larksuiteoAPI/lark-mcp mcp -a <应用_ID> -s <应用_SECRET> For user-身份 APIs (useUAT): first 运行 npx -y @larksuiteoAPI/lark-mcp 记录in -a <应用_ID> -s <应用_SECRET> To enable Video Conferencing + Minutes APIs, 添加: -t pre设置.calendar.default,vc.v1.reserve.应用ly,vc.v1.meeting.获取,vc.v1.meetingRecording.获取,minutes.v1.minute.获取,minutes.v1.minuteTranscript.获取,minutes.v1.minuteStatistic.获取 Full docs: https://open.larkoffice.com/document/home/索引

Core Concepts 工具 Naming

All MCP 工具s use the prefix mcp__lark-mcp__. Example:

mcp__lark-mcp__im.v1.message.创建

身份 Types Parameter Value Meaning useUAT true Act as the 记录ged-in user — resources are owned by the user, directly 访问ible useUAT false (default) Act as the 应用/机器人 — resources owned by the 应用

Use useUAT: true for most interactive operations. Use false for background 自动化.

Standard Parameter Structure path: # URL path parameters (IDs, 令牌s) params: # 查询 string parameters (pagination, 过滤器s, id_type) data: # 请求 body payload useUAT: # true = user 身份, false = 应用 身份

Common ID Types ID 格式化 Represents 应用_令牌 应用XXX Bitable 应用 table_id tblXXX Bitable table record_id recXXX Bitable record open_id ou_XXX User (OpenID) union_id on_XXX User (UnionID, cross-应用) chat_id oc_XXX Group/DM chat message_id om_XXX Individual message document_id doxcXXX Docs document file_令牌 varies Drive file node_令牌 varies Wiki node event_uid varies Calendar event task_图形界面d varies Task 应用roval_code varies 应用roval definition

• Messaging (IM)

工具: mcp__lark-mcp__im.v1.message.创建

params: 接收_id_type: "chat_id" # or: open_id, union_id, emAIl, user_id data: 接收_id: "oc_xxx" msg_type: "text" # text | post | image | interactive | file | audio | media | sticker | 分享_chat | 分享_user content: '{"text":"Hello!"}' useUAT: true

Message types and content 格式化s:

text: {"text": "Hello @user"} post (rich text): {"zh_cn": {"title": "Title", "content": [[{"tag":"text","text":"body"}]]}} interactive (card): JSON card definition — use Card 构建器 at https://open.larkoffice.com/cardkit image: {"image_key": "img_xxx"} (上传 image first via Drive) 分享_chat: {"chat_id": "oc_xxx"} Reply to a Message

工具: mcp__lark-mcp__im.v1.message.reply

path: message_id: "om_xxx" data: content: '{"text":"Got it!"}' msg_type: "text" reply_in_thread: false # true = 创建/continue a thread useUAT: true

列出 Messages in a Chat

工具: mcp__lark-mcp__im.v1.message.列出

params: contAIner_id_type: "chat" contAIner_id: "oc_xxx" page_size: 20 排序_type: "By创建TimeDesc" 启动_time: "1700000000" # optional Unix timestamp end_time: "1700100000" # optional Unix timestamp

获取 a Single Message

工具: mcp__lark-mcp__im.v1.message.获取

path: message_id: "om_xxx"

删除 a Message

工具: mcp__lark-mcp__im.v1.message.删除

path: message_id: "om_xxx" useUAT: true

更新 / Edit a Message (cards or text)

工具: mcp__lark-mcp__im.v1.message.更新

path: message_id: "om_xxx" data: msg_type: "interactive" content: '{"config":{},"elements":[...]}' useUAT: true

添加 a Message Reaction (Emoji)

工具: mcp__lark-mcp__im.v1.messageReaction.创建

path: message_id: "om_xxx" data: reaction_type: emoji_type: "THUMBSUP" # THUMBSUP, OK, HEART, etc. useUAT: true

列出 Message Reactions

工具: mcp__lark-mcp__im.v1.messageReaction.列出

path: message_id: "om_xxx" params: reaction_type: "THUMBSUP" # optional 过滤器

Pin / Unpin a Message

工具: mcp__lark-mcp__im.v1.pin.创建 / mcp__lark-mcp__im.v1.pin.删除

data: message_id: "om_xxx" chat_id: "oc_xxx" useUAT: true

Read Receipts (who has read)

工具: mcp__lark-mcp__im.v1.message.readUsers

path: message_id: "om_xxx" params: user_id_type: "open_id" page_size: 50

• Group / Chat Management

工具: mcp__lark-mcp__im.v1.chat.列出

params: user_id_type: "open_id" page_size: 20

列出 Chats the User Is In

工具: mcp__lark-mcp__im.v1.chat.列出

params: user_id_type: "open_id" page_size: 20 useUAT: true

获取 Chat 信息

工具: mcp__lark-mcp__im.v1.chat.获取

path: chat_id: "oc_xxx" params: user_id_type: "open_id"

创建 a Group Chat

工具: mcp__lark-mcp__im.v1.chat.创建

data: name: "Project Alpha" description: "Discuss Project Alpha here" owner_id: "ou_xxx" # optional, defaults to 应用/user user_id_列出: ["ou_xxx", "ou_yyy"] 机器人_id_列出: [] chat_mode: "group" chat_type: "private" # private | public external: false useUAT: true

更新 Group 信息

工具: mcp__lark-mcp__im.v1.chat.更新

path: chat_id: "oc_xxx" data: name: "New Name" description: "更新d description" owner_id: "ou_xxx" # transfer ownership 添加_member_权限: "all_members" at_all_perm