Install
$ agentstack add skill-mosrat-skills-feishu-mcp-bridge ✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
Verified badge
Passed review? Show it. Paste this badge into your README, it links to the public security report.
Reliability & compatibility
Declared compatibility
Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.
We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.
How agent discovery & health will work →About
飞书工具总技能
重要约定:工具名以 MCP 实际工具名 / tool prompt 为准
例如,日历相关工具应理解为类似下面这种 真实 MCP 工具名,而不是只看分组标题: mcp__feishu-local-mcp-bridge__feishu_calendar_calendar 日历管理 (仅供举例,不一定真实存在,以tools部分为准) 同理,其他模块中的工具,也都应按同样原则处理:以实际 MCP 注册工具名为准,以本文档说明为辅助。
- 你在理解和调用工具时,必须以 工具系统中实际暴露的工具名称 为准。
- 文档中的“能力分组名”“中文标题”“业务简称”“历史别名”都只是辅助说明,不能替代真实工具名。
- 如果本文档中的示例名、分类名,与工具 prompt 中显示的真实工具名不一致,一律以工具 prompt 为准。
- 你在选择工具时,优先依据:
- 工具的真实名称
- 工具 prompt / 描述里的能力边界
- 用户当前意图
- 不要因为文档里写了简化名称,就假设实际可调用名称也是简化名称。
- 当你输出“计划使用哪些工具”时,也应尽量使用真实工具名,避免使用模糊别名。
使用原则
- 你可以优先选择“最贴近用户意图的业务工具”,不要先从底层原始请求思维出发。
- 你可以把“定位对象”与“执行动作”分开:先找人/找会话/找文档,再做更新。
- 你可以在输出中明确“结果是否完整”(例如是否可能还有下一页、是否还有异步状态未收敛)。
1) 文档工具
feishu_fetch_doc
你可以用它读取飞书文档正文,返回 Lark-flavored Markdown。 适用场景:
- “帮我看这篇文档讲了什么”
- “提炼文档重点/生成摘要”
- “检查某章节是否已经更新”
关键语义:
- 文档中的图片/文件/画板通常是 token 占位,不等于已下载的实体文件。
- 传入 wiki 链接时,先识别其真实对象类型;wiki 不一定是 docx。
常见坑:
- 把 token 当成文件内容直接使用。
- 对 wiki 链接直接按 docx 处理导致失败。
示例:
{
"doc_id": "https://xxx.feishu.cn/docx/Z1FjxxxxxxxxxxxxxxxxxxxtnAc"
}
媒体标记示例(读取返回中常见):
feishu_create_doc
你可以用它从 Markdown 创建新文档。 适用场景:
- 报告、会议纪要、方案文档、新页面搭建
- 把聊天结论沉淀为结构化文档
关键语义:
title是文档标题,正文不需要再重复同名一级标题。- 长文档建议“先创建骨架,再分段补充内容”。
- 支持在空间、节点、文件夹语义下创建。
常见坑:
- 一次性写超长正文,导致失败率升高。
- 标题与正文首行重复,影响阅读体验。
示例 1:创建简单文档
{
"title": "项目计划",
"markdown": "# 项目概述\n\n这是一个新项目。\n\n## 目标\n\n- 目标 1\n- 目标 2"
}
示例 2:创建到指定文件夹
{
"title": "会议纪要",
"folder_token": "fldcnXXXXXXXXXXXXXXXXXXXXXX",
"markdown": "# 周会 2025-01-15\n\n## 讨论议题\n\n1. 项目进度\n2. 下周计划"
}
示例 3:创建到知识库节点
{
"title": "技术文档",
"wiki_node": "wikcnXXXXXXXXXXXXXXXXXXXXXX",
"markdown": "# API 接口说明\n\n这是一个知识库文档。"
}
feishu_update_doc
你可以用它更新已有文档,支持追加、局部替换、前后插入、删除和覆盖。 适用场景:
- “只改某一段/某一章”
- “追加更新日志”
- “替换过时描述,不动其他内容”
关键语义:
- 优先局部改动,不要默认整篇覆盖。
- 文本定位要尽量“短而唯一”。
- 大文档更新可能返回异步任务,需要后续追踪。
常见坑:
- 使用覆盖模式导致媒体块、协作痕迹受影响。
- 定位范围过大,误伤无关内容。
示例 1:追加
{
"doc_id": "文档ID或URL",
"mode": "append",
"markdown": "## 新章节\n\n追加的内容..."
}
示例 2:定位替换(selectionwithellipsis)
{
"doc_id": "文档ID或URL",
"mode": "replace_range",
"selection_with_ellipsis": "## 旧章节标题...旧章节结尾。",
"markdown": "## 新章节标题\n\n新的内容..."
}
示例 3:按标题替换整章(selectionbytitle)
{
"doc_id": "文档ID或URL",
"mode": "replace_range",
"selection_by_title": "## 功能说明",
"markdown": "## 功能说明\n\n更新后的功能说明内容..."
}
示例 4:全文多处替换
{
"doc_id": "文档ID或URL",
"mode": "replace_all",
"selection_with_ellipsis": "张三",
"markdown": "李四"
}
示例 5:删除区间
{
"doc_id": "文档ID或URL",
"mode": "delete_range",
"selection_by_title": "## 废弃章节"
}
2) Wiki 与知识库工具
feishu_wiki_space
你可以用它管理知识空间(列出、查看、创建空间)。 适用场景:
- “有哪些知识空间”
- “在某空间新增知识结构”
关键语义:
- 这是空间层工具,常用于导航与组织,而非直接读写正文内容。
feishu_wiki_space_node
你可以用它管理知识节点(列出、查询、创建、移动、复制)。 适用场景:
- “把某文档挪到这个目录下”
- “复制一个知识节点结构”
- “解析 wiki token 对应实际对象”
关键语义:
- 节点可映射到 docx/sheet/bitable 等对象;先解析再分流到对应工具。
常见坑:
- 忽略 obj_type,导致后续调用错工具。
示例:解析 wiki token 后分流
{
"action": "get",
"token": "wiki_token_here"
}
3) IM 消息工具
feishu_im_user_get_messages
你可以用它读取单个会话(群聊/单聊)的历史消息。 适用场景:
- “这个群今天聊了什么”
- “我和某人的最近沟通记录”
关键语义:
- 这是会话时间线视角。
- 返回结果可能含
thread_id,表示可进一步展开话题链。 - 结果可能分页,不代表已经读完全部消息。
示例:
{
"chat_id": "oc_xxx",
"relative_time": "today",
"page_size": 50,
"sort_rule": "create_time_desc"
}
feishu_im_user_get_thread_messages
你可以用它读取 thread 话题内回复。 适用场景:
- “把这个讨论串完整拉出来”
- “看某条消息下面的回复上下文”
关键语义:
- 这是话题链视角,不替代会话主时间线。
示例:
{
"thread_id": "omt_xxx",
"page_size": 10,
"sort_rule": "create_time_desc"
}
feishu_im_user_search_messages
你可以用它跨会话检索消息(关键词、发送者、会话范围、时间过滤)。 适用场景:
- “谁提过这个需求”
- “最近一周所有提到某关键词的消息”
关键语义:
- 先检索定位,再回读上下文。
- 搜索结果适合“发现候选”,不等于最终上下文解释。
示例:
{
"query": "项目进度",
"chat_id": "oc_xxx",
"relative_time": "last_7_days",
"page_size": 50
}
feishu_im_user_fetch_resource
你可以用它下载消息内资源(图片/文件)。 适用场景:
- “把这条消息里的附件拿下来”
- “解析消息里的图片并继续处理”
关键语义:
- 需要
message_id + file_key + type三者一致。
常见坑:
- file_key 来自另一条消息,导致下载失败。
示例(下载图片):
{
"message_id": "om_xxx",
"file_key": "img_v3_xxx",
"type": "image"
}
示例(下载文件):
{
"message_id": "om_xxx",
"file_key": "file_v3_xxx",
"type": "file"
}
feishu_im_user_message
你可以用它以用户身份发消息或回复消息。 适用场景:
- “代表用户回复某消息”
- “向指定会话发送结构化内容”
关键语义:
- 回复模式与发送模式是两套语义:一个针对消息链,一个针对接收对象。
示例(发送):
{
"action": "send",
"receive_id_type": "chat_id",
"receive_id": "oc_xxx",
"msg_type": "text",
"content": "{\"text\":\"你好\"}"
}
示例(回复):
{
"action": "reply",
"message_id": "om_xxx",
"msg_type": "text",
"content": "{\"text\":\"收到\"}"
}
4) 日历工具
feishu_calendar_event
你可以用它创建、查询、更新、删除、搜索、回复日程,并处理重复日程实例。 适用场景:
- “安排会议并邀请参与人”
- “查某时间段的行程”
- “修改会议时间”
- “回复会议邀请”
关键语义:
list/instance_view:看时间窗内实际发生实例。instances:看某重复事件的实例展开。reply:表达参会状态,不是编辑日程内容。
常见坑:
- 混淆普通日程与重复日程接口语义。
- 创建后未补参会人,协作链路不完整。
示例 1:创建会议
{
"action": "create",
"summary": "项目复盘会议",
"description": "讨论 Q1 项目进展",
"start_time": "2026-02-25T14:00:00+08:00",
"end_time": "2026-02-25T15:30:00+08:00",
"user_open_id": "ou_aaa",
"attendees": [
{"type": "user", "id": "ou_bbb"},
{"type": "user", "id": "ou_ccc"},
{"type": "resource", "id": "omm_xxx"}
]
}
示例 2:查询时间窗日程
{
"action": "list",
"start_time": "2026-02-25T00:00:00+08:00",
"end_time": "2026-03-03T23:59:00+08:00"
}
示例 3:回复邀请
{
"action": "reply",
"event_id": "xxx_0",
"rsvp_status": "accept"
}
feishu_calendar_event_attendee
你可以用它管理日程参会人。 适用场景:
- “给这个日程追加参会人”
- “查看参会状态”
关键语义:
- 会议室等资源参会人可能是异步状态,短时间内未最终确认。
示例:
{
"action": "list",
"calendar_id": "cal_xxx",
"event_id": "evt_xxx"
}
feishu_calendar_calendar
你可以用它查看日历实体信息。 适用场景:
- “我有哪些日历”
- “获取目标日历信息后再操作事件”
feishu_calendar_freebusy
你可以用它查询忙闲时间。 适用场景:
- “排会前找共同空档”
关键语义:
- 这是排期工具,不是会议详情工具。
示例:
{
"action": "list",
"time_min": "2026-02-25T09:00:00+08:00",
"time_max": "2026-02-25T18:00:00+08:00",
"user_ids": ["ou_aaa", "ou_bbb", "ou_ccc"]
}
5) 任务工具
feishu_task_task
你可以用它创建、查询、更新任务。 适用场景:
- “创建待办并指定负责人”
- “把任务标记完成/恢复未完成”
- “调整截止时间和描述”
关键语义:
- 成员角色影响后续可见与可编辑范围。
- 完成状态是时间语义驱动,不只是布尔切换。
示例 1:创建任务
{
"action": "create",
"summary": "准备周会材料",
"description": "整理本周工作进展和下周计划",
"current_user_id": "ou_发送者open_id",
"members": [
{"id": "ou_协作者open_id", "role": "assignee"}
]
}
示例 2:完成任务
{
"action": "patch",
"task_guid": "task_xxx",
"completed_at": "2026-02-26T15:30:00+08:00"
}
示例 3:反完成
{
"action": "patch",
"task_guid": "task_xxx",
"completed_at": "0"
}
feishu_task_tasklist
你可以用它创建和管理任务清单。 适用场景:
- “按项目组织任务”
- “查看清单下任务”
- “给清单加成员”
关键语义:
- 清单用于组织维度,任务用于执行维度。
示例:
{
"action": "create",
"name": "产品迭代 v2.0",
"members": [
{"id": "ou_xxx", "role": "editor"},
{"id": "ou_yyy", "role": "viewer"}
]
}
feishu_task_comment
你可以用它对任务写评论、读评论。 适用场景:
- “补充任务背景”
- “沉淀决策记录”
示例:
{
"action": "create",
"task_guid": "task_xxx",
"content": "这项任务需要在周五前完成。"
}
feishu_task_subtask
你可以用它拆分子任务并查看子任务。 适用场景:
- “把大任务拆成可执行子项”
示例:
{
"action": "create",
"task_guid": "task_xxx",
"summary": "完成接口文档"
}
常见坑(任务域):
- 只建任务不合理设置成员,后续看得到但改不了。
- 清单与任务关系未理顺,导致查询视角混乱。
6) 多维表格(Bitable)工具
feishu_bitable_app
你可以用它创建和管理 Bitable App。 适用场景:
- “新建业务台账系统”
- “复制一套现有数据结构”
示例:
{
"action": "create",
"name": "客户跟进台账"
}
feishu_bitable_app_table
你可以用它管理数据表(表级别)。 适用场景:
- “在 App 下新建表”
- “调整表结构策略”
示例:
{
"action": "create",
"app_token": "app_xxx",
"name": "客户列表"
}
feishu_bitable_app_table_field
你可以用它管理字段(列)。 适用场景:
- “增加负责人字段/状态字段/日期字段”
- “更新字段配置”
关键语义:
- 字段 type 决定记录值结构,写记录前先理解字段定义。
示例:
{
"action": "create",
"app_token": "app_xxx",
"table_id": "tbl_xxx",
"field_name": "负责人",
"type": 11
}
feishu_bitable_app_table_record
你可以用它增删改查记录(行数据),支持批量。 适用场景:
- “批量导入客户清单”
- “筛选出状态为进行中的记录”
- “批量修正字段值”
关键语义:
- 人员、日期、单选、多选、附件字段格式各不相同。
- 批量写有上限,且同表并发写容易冲突。
示例 1:新增记录
{
"action": "create",
"app_token": "app_xxx",
"table_id": "tbl_xxx",
"fields": {
"客户名称": "Bytedance",
"负责人": [{"id": "ou_xxx"}],
"签约日期": 1674206443000,
"状态": "进行中"
}
}
示例 2:批量导入
{
"action": "batch_create",
"app_token": "app_xxx",
"table_id": "tbl_xxx",
"records": [
{"fields": {"客户名称": "Bytedance", "状态": "进行中"}},
{"fields": {"客户名称": "飞书", "状态": "已完成"}}
]
}
示例 3:筛选查询
{
"action": "list",
"app_token": "app_xxx",
"table_id": "tbl_xxx",
"filter": {
"conjunction": "and",
"conditions": [
{"field_name": "状态", "operator": "is", "value": ["进行中"]}
]
}
}
feishu_bitable_app_table_view
你可以用它管理视图。 适用场景:
- “为不同角色创建专用视图”
- “沉淀筛选与排序结果”
示例:
{
"action": "create",
"app_token": "app_xxx",
"table_id": "tbl_xxx",
"view_name": "进行中任务",
"view_type": "grid"
}
常见坑(Bitable 域):
- 字段值格式与字段类型不匹配导致批量失败。
- 并发更新同一表引发写冲突。
- 先写记录后补字段定义,导致数据不一致。
7) 云盘、评论与媒体工具
feishu_drive_file
你可以用它做文件级操作:列举、元数据、复制、移动、删除、上传、下载。 适用场景:
- “整理目录结构”
- “搬移/复制业务文件”
- “获取文件元信息”
示例(列出文件):
{
"action": "list",
"folder_token": "fldcn_xxx",
"page_size": 20
}
feishu_doc_comments
你可以用它读写文档评论、更新评论状态。 适用场景:
- “拉取文档评论线程”
- “添加评审意见”
- “标记评论已解决”
关键语义:
- 评论属于协作层,不等于正文内容本身。
示例 1:列评论
{
"action": "list",
"file_token": "doxcn_xxx",
"file_type": "docx"
}
示例 2:创建评论
{
"action": "create",
"file_token": "doxcn_xxx",
"file_type": "docx",
"elements": [
{"type": "text", "text": "这段建议补充数据来源。"}
]
}
feishu_doc_media
你可以用它处理文档媒体(插入/下载)。 适用场景:
- “把本地图片插入文档”
- “下载文档中的媒体资源”
关键语义:
- 媒体 token 与文档块结构绑定,修改正文时要避免误破坏关联关系。
示例 1:插入媒体
{
"action": "insert",
"doc_id": "doxcn_xxx",
"file_path": "/tmp/example.png",
"type": "image"
}
示例 2:下载媒体
{
"action": "download",
"resource_token": "Z1FjxxxxxxxxxxxxxxxxxxxtnAc",
"resource_type": "media",
"output_path": "/tmp/downloaded.bin"
}
8) 用户、会话与搜索工具
feishu_get_user
你可以用它获取当前用户信息或指定用户信息。 适用场景:
- “确认用户身份”
- “补齐后续调用需要的用户资料”
示例:
{
"user_id": "ou_xxx",
"user_id_type": "open_id"
}
feishu_search_user
你可以用它按关键词检索用户。 适用场景:
- “用户只给了姓名/模糊描述”
示例:
{
"query": "张三",
"page_size": 20
}
feishu_chat / feishu_chat_members
你可以用它定位会话并读取成员。 适用场景:
- “先找群,再读消息/发消息”
- “查看群成员范围”
示例 1:搜索会话
{
"action": "search",
"query": "项目群"
}
示例 2:读成员
{
"chat_id": "oc_xxx",
"page_size": 50
}
feishu_search_doc_wiki
你可以用它跨文档/知识库搜索。 适用场景:
- “先找相关文档,再做读取或更新”
关键语义(定位层):
- 当用户输入是“模糊对象”(人名、关键词、模糊文档)时,先用搜索/定位工具再执行实体动作。
示例:
{
"action": "search",
"query": "季度复盘",
"page_size": 10
}
9) 组合流程建议
文档知识流
- 搜索/定位文档
- 读取正文
- 局部更新
- 如有媒体再处理 token 资源
消息证据流
- 全局搜索消息
- 回读会话上下文
- 展开 thread
- 抽取并下载关键资源
会议协同流
- 创建日程
- 添加参会人
- 查询 RSVP / 资源状态
- 按反馈修改日程
数据台账流
- 建 App / 建表 / 建字段
- 批量导入
- 筛选查询与视图固化
- 批量更新维护
实例:
```md examples
日历相关
| 工具名称 | 功能描述 | |---------|---------| | mcp__feishu-local-mcp-bridge__feishu_calendar_calendar | 日历管理 | | mcp__feishu-local-mcp-bridge__feishu_calendar_event | 日历事件操作 | | mcp__feishu-local-mcp-bridge__feishu_calendar_event_attendee | 日历事件参与者 | | mcp__feishu-local-mcp-bridge__feishu_calendar_freebusy | 查询空闲忙碌时间 |
文档相关
| 工具名称 | 功能描述 | |---------|---------| | mcp__feishu-local-mcp-bridge__feishu_fetch_doc | 获取文档内容 | | mcp__feishu-local-mcp-bridge__feishu_update_doc | 更新文档内容 | | mcp__feishu-local-mcp-bridge__feishu_create_doc | 创建新文档 | | mcp__feishu-local-mcp-bridge__feishu_doc_comments | 文档评论 | | mcp__feishu-local-mcp-bridge__feishu_doc_media | 文档媒体操作 |
消息相关
| 工具名称 | 功能描述 | |---------|---------| | mcp__feishu-local-mcp-bridge__feishu_im_user_message | 发送/回复消息 | | mcp__feishu-local-mcp-bridge__feishu_im_user_get_messages | 获取消息列表 | | mcp__feishu-local-mcp-bridge__feishu_im_user_get_thread_messages | 获取线程消息 | | mcp__feishu-local-mcp-bridge__feishu_im_user_fetch_resource | 获取消息资源 | | mcp__feishu-local-mcp-bridge__feishu_im_user_search_messages | 搜索消息 |
用户与群组
| 工具名称 | 功能描述 | |---------|---------| | mcp__feishu-local-mcp-bridge__feishu_search_user | 搜索用户 | | mcp__feishu-local-mcp-bridge__feishu_get_user | 获取用户信息 | | mcp__feishu-local-mcp-bridge__feishu_chat | 搜索/获取群组 | | mcp__feishu-local-mcp-bridge__feishu_chat_members | 获取群组成员 |
任务相关
| 工具名称 | 功能描述 | |---------|---------| | mcp__feishu-local-mcp-bridge__feishu_task_task | 任务操作 | | mcp__feishu-local-mcp-bridge__feishu_task_tasklist | 任务列表管理 | | mcp__feishu-local-mcp-bridge__feishu_task_subtask | 子任务操作 | | mcp__feishu-local-mcp-bridge__feishu_task_comment | 任务评论 |
云文档/知识库
| 工具名称 | 功能描述 | |---------|---------| | mcp__feishu-local-mcp-bridge__feishu_drive_file | 云文档文件操作 | | mcp__feishu-local-mcp-bridge__feishu_wiki_space | 知识库空间 | | mcp__feishu-local-mcp-bridge__feishu_wiki_space_node | 知识库节点 | | mcp__feishu-local-mcp-bridge__feishu_search_doc_wiki | 搜索文档/知识库 |
多维表格(Bitsum)
| 工具名称 | 功能描述 | |---------|---------| | mcp__feishu-local-mcp-bridge__feishu_bitable_app | 多维表格操作 | | mcp__feishu-local-mcp-bridge__feishu_bitable_app_table | 多维表格中的数据表 | | mcp__feishu-local-mcp-bridge__feishu_bitable_app_table_field | 数据表字段 | | mcp__feishu-local-mcp-bridge__feishu_bitable_app_table_record | 数据表记录 | | mcp__feishu-local-mcp-bridge__feishu_bitable_app_table_view | 数据表视图 |
表格
| 工具名称 | 功能描述 | |---------|---------| | mcp__feishu-local-mcp-bridge__feishu_sheet | 电子表格操作 |
## Source & license
This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.
- **Author:** [MosRat](https://github.com/MosRat)
- **Source:** [MosRat/SKILLS](https://github.com/MosRat/SKILLS)
- **License:** MIT
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet, be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.