飞书文档 MCP 接入指南本文档说明如何在支持 MCPModel Context Protocol的 AI 工具中接入飞书官方 MCP实现直接读取飞书文档、Wiki 知识库以及在指定目录创建文档的能力。一、基本信息MCP 包名larksuiteoapi/lark-mcp官方仓库https://github.com/larksuite/lark-openapi-mcp飞书应用 App IDcli_axxxxxxxxxxxxxxx飞书应用 App Secretxxxxxxxxxxxxxxx敏感信息请勿提交到公开仓库二、前置条件Node.js 18推荐 v22已安装 npx随 npm 自带使用任意支持 MCP stdio 协议的 AI 工具Cursor、Claude Desktop、Kiro、Continue 等三、MCP 配置所有支持 MCP 的工具配置格式基本一致核心配置如下{ mcpServers: { lark-mcp: { command: npx, args: [ -y, larksuiteoapi/lark-mcplatest, mcp, --app-id, cli_xxxxxx, --app-secret, xxxxxx, --token-mode, tenant_access_token, --tools, preset.default,wiki.v2.spaceNode.create,wiki.v2.spaceNode.moveDocsToWiki,wiki.v2.spaceNode.move,docx.v1.documentBlockChildren.create,docx.v1.documentBlock.patch,docx.v1.documentBlock.get,docx.v1.documentBlockChildren.get ] } } }各工具配置文件路径Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonmacOSCursor~/.cursor/mcp.json 或项目根目录 .cursor/mcp.jsonKiro~/.kiro/settings/mcp.json全局或项目 .kiro/settings/mcp.jsonContinue~/.continue/config.json 中的 mcpServers 字段Windsurf~/.codeium/windsurf/mcp_config.json四、开启 Wiki 目录创建能力关键配置lark-mcp 默认只开启 preset.default 工具集不包含 wiki 节点创建 / 移动接口以及文档块级读取、追加、编辑接口。通过在 args 中加入 --tools 参数可以额外开启实现直接在指定 wiki 目录下创建文档并支持后续按块读写文档内容。改动说明在 mcp.json 的 lark-mcp args 数组末尾加入以下两项其中第二项为完整工具串--tools, preset.default,wiki.v2.spaceNode.create,wiki.v2.spaceNode.moveDocsToWiki,wiki.v2.spaceNode.move,docx.v1.documentBlockChildren.create,docx.v1.documentBlock.patch,docx.v1.documentBlock.get,docx.v1.documentBlockChildren.get新增七个工具说明wiki.v2.spaceNode.create在指定 wiki 节点下直接创建子文档无需移动一步到位wiki.v2.spaceNode.moveDocsToWiki将普通云文档移入 wiki 知识库指定节点wiki.v2.spaceNode.move在 wiki 内部移动节点位置docx.v1.documentBlockChildren.create向指定文档块下追加子块适合 AI 连续写入段落、列表、代码块等内容docx.v1.documentBlock.patch更新已有文档块内容适合修订、替换或补写既有文档片段docx.v1.documentBlock.get读取单个文档块详情便于精确定位目标块并确认当前内容docx.v1.documentBlockChildren.get读取指定块的子块列表便于遍历章节结构、查找插入点和确认层级关系前置条件目标 wiki 节点需将飞书应用cli_aa847619b7781cc2添加为「可管理」协作者配置修改后需重启编辑器或在 MCP Server 面板重连 lark-mcp 才能生效五、已开通的飞书应用权限以下权限已申请并发布无需重复申请wiki:wiki:readonly — 读取知识库 / Wikiwiki:wiki — 创建、编辑、移动 Wiki 节点含 spaceNode.create / moveDocsToWiki / movedocx:document:readonly — 读取新版飞书文档docx:document — 创建、编辑新版飞书文档docs:doc:readonly — 读取旧版飞书文档drive:drive:readonly — 读取云盘文件drive:file — 管理云盘文件移动、删除、权限bitable:app — 读写多维表格im:message — 发送消息im:message:send_as_bot — 以机器人身份发消息如需申请其他权限访问https://open.feishu.cn/app/cli_aa847619b7781cc2/auth六、lark-mcp 支持的全量工具分类lark-mcp 内置超过 600 个工具覆盖飞书全产品线。默认 preset.default 只开启常用工具子集可通过 --tools 参数按需开启。文档类docx / docs / drive / wikidocx.v1.document.create / get / rawContent / convert — 文档创建、读取、转换docx.v1.documentBlock.* — 文档块操作增删改查drive.v1.file.* — 云盘文件管理移动、复制、删除、上传drive.v1.permissionMember.* — 文档权限管理wiki.v2.spaceNode.create / move / moveDocsToWiki / copy / list — Wiki 节点操作wiki.v2.space.* — Wiki 空间管理消息类imim.v1.message.create / reply / update / delete / list — 消息发送与管理im.v1.chat.create / get / list / update — 群组管理其他模块bitable.* — 多维表格App、Table、Record、Field、Viewcontact.v3.user.* / department.* — 通讯录用户与部门管理calendar — 日历与日程管理task.v2 — 任务管理sheets.v3 — 电子表格操作hire / corehr / performance — 招聘、人事、绩效vc — 视频会议 okr — OKR 管理完整工具列表查看命令npx larksuiteoapi/lark-mcplatest mcp --help七、常见问题Q: 报错 99991672 Access denied权限未开通或应用未发布新版本。检查飞书开放平台 → 权限管理确认所需权限已申请并在版本管理中发布新版本。Q: 创建文档后无法移动到 wiki 目录原因普通 import 接口不支持指定目标目录且应用创建的文档归属应用所有个人账号无法移动。解决方案使用 wiki.v2.spaceNode.create 直接在目标节点下创建无需移动。Q: 新增工具后 AI 仍无法调用修改 mcp.json 后需重启编辑器或在 MCP Server 面板手动重连 lark-mcp。八、相关链接飞书开放平台应用管理https://open.feishu.cn/app/cli_aa847619b7781cc2lark-openapi-mcp 官方仓库https://github.com/larksuite/lark-openapi-mcpMCP 协议说明https://modelcontextprotocol.io九、MCP 更新功能测试✅ MCP 更新功能验证成功。本条目由 AI 通过 tenant_access_token 调用 docx.v1.documentBlockChildren.create 接口写入再通过 docx.v1.documentBlock.patch 接口修改验证应用身份对自身创建的文档同时具备「追加」和「编辑」权限。测试时间2026-05-28