Installation

$ npx skills add whatevertogo/feishuskill --skill lark-mcp

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared

Cursor Not declared

Codex Not declared

GitHub Copilot Not declared

Windsurf Not declared

Gemini CLI Not declared

Cline Not declared

OpenCode Not declared

Repository health

Stars 38

License LICENSE

Default branch main

Open issues 0

Status Archived

Package contents

Files included with this skill beyond the listing page.

skill md SKILL.md 3,952 B

docs SUMMARY.md 247 B

History

Jan 20, 2026 First seen on skills.sh

Sep 9, 2026 First recorded snapshot · 3,108 installs

SKILL.md

Lark MCP

⚠️ 重要提醒

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

docxbuiltinsearch → 需要 --oauth
wikiv1node_search → 需要 --oauth

否则返回 99991663 错误。配置方法见 [installation.md](reference/installation.md#oauth-配置)

核心规则

# 工具命名（连字符，非下划线）
✅ 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`

工具速查

类别	工具	文档
消息	`imv1messagecreate`, `im``v1messagelist`	[im.md](reference/im.md)
群组	`imv1chatcreate`, `im``v1chatlist`, `imv1chatMembers_get`	[chat.md](reference/chat.md)
多维表格	`bitablev1appcreate`, `bitable``v1appTableRecordsearch/create/update`	[bitable.md](reference/bitable.md)
文档	`docxbuiltinsearch`, `docxv1documentrawContent`, `docx``builtin_import`	[documents.md](reference/documents.md)
知识库	`wikiv1nodesearch`, `wiki``v2spacegetNode`	[wiki.md](reference/wiki.md)

ID 类型

前缀	类型	来源
`ou_`	用户ID	API返回
`oc_`	群聊ID	`imv1chat_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	服务器名错误	使用 `mcplark-mcp` 前缀
99991663	权限不足	`useUAT: true` 或配置 OAuth
131005 not found	token 类型错误	检查用 `wikcn` 还是 `doxcn`
创建资源无法访问	租户身份创建	使用 `useUAT: true`
field not found	字段名错误	用 `appTableField_list` 确认
invalid content	格式错误	content 用单引号包裹 JSON

详细文档: [troubleshooting.md](reference/troubleshooting.md) | [installation.md](reference/installation.md)

lark-mcp