AgentStack
Browse Sign in
Browse Why AgentStack Sell Docs
Sign in
SKILL verified MIT Self-run

Feishu Mcp Bridge

skill-mosrat-skills-feishu-mcp-bridge · by MosRat

|

No reviews yet
0 installs
38 views
0.0% view→install

Install

$ agentstack add skill-mosrat-skills-feishu-mcp-bridge

✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.

Security review

✓ Passed

No 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.

View the full security report →

Verified badge

Passed review? Show it. Paste this badge into your README, it links to the public security report.

AgentStack Verified badge Links to your public security report.
[![AgentStack Verified](https://agentstack.voostack.com/badges/verified.svg)](https://agentstack.voostack.com/security/report/skill-mosrat-skills-feishu-mcp-bridge)

Reliability & compatibility

Security review passed
0 installs to date
no reviews yet
6mo ago

Declared compatibility

Claude CodeClaude Desktop

Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.

Preview Execution monitoring

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 →
Are you the author of Feishu Mcp Bridge? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

About

飞书工具总技能

重要约定:工具名以 MCP 实际工具名 / tool prompt 为准

例如,日历相关工具应理解为类似下面这种 真实 MCP 工具名,而不是只看分组标题: mcp__feishu-local-mcp-bridge__feishu_calendar_calendar 日历管理 (仅供举例,不一定真实存在,以tools部分为准) 同理,其他模块中的工具,也都应按同样原则处理:以实际 MCP 注册工具名为准,以本文档说明为辅助。

  • 你在理解和调用工具时,必须以 工具系统中实际暴露的工具名称 为准。
  • 文档中的“能力分组名”“中文标题”“业务简称”“历史别名”都只是辅助说明,不能替代真实工具名
  • 如果本文档中的示例名、分类名,与工具 prompt 中显示的真实工具名不一致,一律以工具 prompt 为准
  • 你在选择工具时,优先依据:
  1. 工具的真实名称
  2. 工具 prompt / 描述里的能力边界
  3. 用户当前意图
  • 不要因为文档里写了简化名称,就假设实际可调用名称也是简化名称。
  • 当你输出“计划使用哪些工具”时,也应尽量使用真实工具名,避免使用模糊别名。

使用原则

  • 你可以优先选择“最贴近用户意图的业务工具”,不要先从底层原始请求思维出发。
  • 你可以把“定位对象”与“执行动作”分开:先找人/找会话/找文档,再做更新。
  • 你可以在输出中明确“结果是否完整”(例如是否可能还有下一页、是否还有异步状态未收敛)。

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) 组合流程建议

文档知识流

  1. 搜索/定位文档
  2. 读取正文
  3. 局部更新
  4. 如有媒体再处理 token 资源

消息证据流

  1. 全局搜索消息
  2. 回读会话上下文
  3. 展开 thread
  4. 抽取并下载关键资源

会议协同流

  1. 创建日程
  2. 添加参会人
  3. 查询 RSVP / 资源状态
  4. 按反馈修改日程

数据台账流

  1. 建 App / 建表 / 建字段
  2. 批量导入
  3. 筛选查询与视图固化
  4. 批量更新维护

实例:

```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.

Versions

  • v0.1.0 Imported from the upstream source.