whatevertogo avatar
24

This skill provides integration with Feishu/Lark, enabling automated operations such as sending messages, creating groups, managing multi-dimensional tables, importing/searching documents, and querying knowledge bases. It offers key capabilities like document search, message creation, group management, and data operations, optimized through OAuth configurations for secure access. Suitable for developers or users aiming to automate and streamline their workflow within the Feishu/Lark ecosystem.

npx skills add https://github.com/whatevertogo/feishuskill --skill lark-mcp

Lark MCP

⚠️ 重要提醒

搜索文档/知识库必须配置 OAuth：

  • docx_builtin_search → 需要 --oauth
  • wiki_v1_node_search → 需要 --oauth 否则返回 99991663 错误。配置方法见 installation.md

核心规则

# 工具命名（连字符，非下划线）
✅ mcp__lark-mcp__tool_name
❌ mcp__lark_mcp__tool_name
# 参数结构
path: {app_token, table_id}   # URL路径参数
params: {page_size, ...}      # 查询参数
data: {fields, ...}           # 请求体
useUAT: false                 # true=用户身份, false=租户身份

常见陷阱

# content 必须是 JSON 字符串
❌ content: {"text": "hello"}
✅ content: '{"text": "hello"}'
# 过滤条件 value 必须是数组
❌ value: "已完成"
✅ value: ["已完成"]
# 创建群组必须指定 owner_id，否则群主为机器人
owner_id: "ou_xxxxx"
# 参数名差异
docx_builtin_search: search_key  # 不是 query
wiki_v1_node_search: query       # 不是 search_key
# token 类型
wiki_v2_space_getNode: 用 wikcn...  # 不能用 doxcn...
docx_v1_document_rawContent: 用 doxcn...

useUAT 选择

场景 useUAT 创建资源（想让用户可访问） true 搜索文档/知识库 true 访问用户私有数据 true 查询公共数据 false

工具速查

类别 工具 文档 消息 im_v1_message_create, im_v1_message_list im.md 群组 im_v1_chat_create, im_v1_chat_list, im_v1_chatMembers_get chat.md 多维表格 bitable_v1_app_create, bitable_v1_appTableRecord_search/create/update bitable.md 文档 docx_builtin_search, docx_v1_document_rawContent, docx_builtin_import documents.md 知识库 wiki_v1_node_search, wiki_v2_space_getNode wiki.md

ID 类型

前缀 类型 来源 ou_ 用户ID API返回 oc_ 群聊ID im_v1_chat_list bascn 多维表格 URL中 base/ 后 tbl 数据表 URL参数 table= doxcn 文档 搜索结果或URL wikcn 知识库节点 知识库URL

快速示例

# 发送消息
工具: mcp__lark-mcp__im_v1_message_create
data:
  receive_id: "oc_xxxxx"
  msg_type: "text"
  content: '{"text": "消息内容"}'
params:
  receive_id_type: "chat_id"
# 创建群组
工具: mcp__lark-mcp__im_v1_chat_create
data:
  name: "群名"
  chat_mode: "group"
  owner_id: "ou_xxxxx"
  user_id_list: ["ou_xxxxx"]
params:
  user_id_type: "open_id"
# 创建多维表格记录
工具: mcp__lark-mcp__bitable_v1_appTableRecord_create
path:
  app_token: "bascnxxxxxx"
  table_id: "tblxxxxxx"
data:
  fields:
    文本字段: "值"
    单选字段: "选项名"
useUAT: true
# 搜索文档
工具: mcp__lark-mcp__docx_builtin_search
data:
  search_key: "关键词"
  count: 10
useUAT: true

错误速查

错误 原因 解决 tool not found 服务器名错误 使用 mcp__lark-mcp__ 前缀 99991663 权限不足 useUAT: true 或配置 OAuth 131005 not found token 类型错误 检查用 wikcn 还是 doxcn 创建资源无法访问 租户身份创建 使用 useUAT: true field not found 字段名错误 用 appTableField_list 确认 invalid content 格式错误 content 用单引号包裹 JSON 详细文档: troubleshooting.md | installation.md

GitHub Owner

Owner: whatevertogo

Files

installation.md

im.md

chat.md

bitable.md

documents.md

wiki.md

troubleshooting.md

installation.md

SKILL.md

name: lark-mcp description: 飞书/Lark 官方 MCP 集成。支持发送消息、创建群组、操作多维表格（Bitable）、导入/搜索文档、知识库查询。触发词：飞书、Feishu、Lark、多维表格、bitable、飞书文档、飞书群。

Lark MCP

⚠️ 重要提醒

搜索文档/知识库必须配置 OAuth：

  • docx_builtin_search → 需要 --oauth
  • wiki_v1_node_search → 需要 --oauth 否则返回 99991663 错误。配置方法见 installation.md

核心规则

# 工具命名（连字符，非下划线）
✅ mcp__lark-mcp__tool_name
❌ mcp__lark_mcp__tool_name
# 参数结构
path: {app_token, table_id}   # URL路径参数
params: {page_size, ...}      # 查询参数
data: {fields, ...}           # 请求体
useUAT: false                 # true=用户身份, false=租户身份

常见陷阱

# content 必须是 JSON 字符串
❌ content: {"text": "hello"}
✅ content: '{"text": "hello"}'
# 过滤条件 value 必须是数组
❌ value: "已完成"
✅ value: ["已完成"]
# 创建群组必须指定 owner_id，否则群主为机器人
owner_id: "ou_xxxxx"
# 参数名差异
docx_builtin_search: search_key  # 不是 query
wiki_v1_node_search: query       # 不是 search_key
# token 类型
wiki_v2_space_getNode: 用 wikcn...  # 不能用 doxcn...
docx_v1_document_rawContent: 用 doxcn...

useUAT 选择

场景useUAT
创建资源（想让用户可访问）true
搜索文档/知识库true
访问用户私有数据true
查询公共数据false

工具速查

类别工具文档
消息im_v1_message_create, im_v1_message_listim.md
群组im_v1_chat_create, im_v1_chat_list, im_v1_chatMembers_getchat.md
多维表格bitable_v1_app_create, bitable_v1_appTableRecord_search/create/updatebitable.md
文档docx_builtin_search, docx_v1_document_rawContent, docx_builtin_importdocuments.md
知识库wiki_v1_node_search, wiki_v2_space_getNodewiki.md

ID 类型

前缀类型来源
ou_用户IDAPI返回
oc_群聊IDim_v1_chat_list
bascn多维表格URL中 base/ 后
tbl数据表URL参数 table=
doxcn文档搜索结果或URL
wikcn知识库节点知识库URL

快速示例

# 发送消息
工具: mcp__lark-mcp__im_v1_message_create
data:
  receive_id: "oc_xxxxx"
  msg_type: "text"
  content: '{"text": "消息内容"}'
params:
  receive_id_type: "chat_id"
# 创建群组
工具: mcp__lark-mcp__im_v1_chat_create
data:
  name: "群名"
  chat_mode: "group"
  owner_id: "ou_xxxxx"
  user_id_list: ["ou_xxxxx"]
params:
  user_id_type: "open_id"
# 创建多维表格记录
工具: mcp__lark-mcp__bitable_v1_appTableRecord_create
path:
  app_token: "bascnxxxxxx"
  table_id: "tblxxxxxx"
data:
  fields:
    文本字段: "值"
    单选字段: "选项名"
useUAT: true
# 搜索文档
工具: mcp__lark-mcp__docx_builtin_search
data:
  search_key: "关键词"
  count: 10
useUAT: true

错误速查

错误原因解决
tool not found服务器名错误使用 mcp__lark-mcp__ 前缀
99991663权限不足useUAT: true 或配置 OAuth
131005 not foundtoken 类型错误检查用 wikcn 还是 doxcn
创建资源无法访问租户身份创建使用 useUAT: true
field not found字段名错误用 appTableField_list 确认
invalid content格式错误content 用单引号包裹 JSON
详细文档: troubleshooting.mdinstallation.md

More skills

G
Recipe Post Mortem Setup

googleworkspace

A
Canvas Design

anthropics

A
Docx

anthropics