- ·larksuite-cli 支持 JSON 输出,全非交互模式
- ·lark-openapi-mcp 官方 MCP,覆盖消息/文档/日历等所有核心域
- ·官方维护,文档完整,命令示例丰富
- ·22 个 agent_skills,功能覆盖最广
功能覆盖矩阵
消息 / IM
3/5 支持命令
lark im message send --user @alice --text 'Hello'
输入参数
--user: 用户 open_id 或 @mention --text: 消息文字内容
示例输出
{ "message_id": "om_xxx", "status": "sent" }
备注:支持 text / markdown / card 格式
命令
lark im message send --chat @dev-team --text 'Deploy done'
输入参数
--chat: 群组 chat_id 或 @mention
示例输出
{ "message_id": "om_xxx" } 命令
mcp call im.message.create type=interactive card='{...}' 输入参数
card: 飞书卡片 JSON(支持 Button / InputForm / Markdown)
示例输出
{ "message_id": "om_xxx" } 备注:MCP 工具直接调用 OpenAPI,card 内容自由组合
Gap:CLI 暂未实现,API 支持但需代码调用
命令
mcp call im.message.list container_id_type=chat container_id=xxx
备注:MCP 可获取消息列表,但不区分已读/未读
Gap:未读标记需通过 im.message.patch 单独更新
云文档
4/5 支持命令
lark docs create --title '会议记录' --folder-token fldcnXxx
输入参数
--title: 文档标题 --folder-token: 目标文件夹 token
示例输出
{ "doc_token": "doxcnXxx", "url": "https://feishu.cn/docx/..." } 命令
mcp call docx.document.raw_content document_id=doxcnXxx
示例输出
{ "content": "# 标题\n\n正文..." } 备注:返回 Markdown 纯文本,适合 AI 摘要
命令
mcp call docx.document.block.children.create document_id=doxcnXxx children='[{...}]' 输入参数
children: Block JSON 数组(paragraph / heading / code / table)
示例输出
{ "children": [...] } Gap:仅限 GUI,未开放 API
命令
mcp call drive.file.comment.create file_token=doxcnXxx content='LGTM'
示例输出
{ "comment_id": "xxx" } 多维表格 / Bitable
4/5 支持命令
mcp call bitable.app.create name='任务追踪'
示例输出
{ "app_token": "bascnXxx", "url": "https://feishu.cn/base/..." } 命令
mcp call bitable.app.table.record.create app_token=bascnXxx table_id=tblXxx fields='{"标题":"Bug #123","状态":"待处理"}' 示例输出
{ "record_id": "recXxx" } 命令
mcp call bitable.app.table.record.list app_token=bascnXxx table_id=tblXxx filter='CurrentValue.[状态]="待处理"'
示例输出
{ "items": [...], "total": 12 } 备注:支持过滤表达式,最多返回 500 条
命令
mcp call bitable.app.table.field.create app_token=bascnXxx table_id=tblXxx field_name='优先级' type=3
示例输出
{ "field_id": "fldXxx" } Gap:表单提交仅限 Web GUI,API 无对应入口
日历
3/4 支持命令
mcp call calendar.event.create calendar_id=primary summary='周会' start_time=1735200000 end_time=1735203600
输入参数
summary: 日程标题 start_time / end_time: Unix 时间戳(秒)
示例输出
{ "event_id": "evtXxx" } 命令
mcp call calendar.event.list calendar_id=primary start_time=1735200000 end_time=1735286400
示例输出
{ "items": [...] } 命令
mcp call calendar.event.delete calendar_id=primary event_id=evtXxx
示例输出
{} 备注:需先查询 room_id,再将 room 添加至 event attendees
Gap:无专用 book-room 命令,需多步骤组合
视频会议
1/3 支持命令
mcp call vc.reserve.apply reserve_type=1
示例输出
{ "reserve_id": "xxx", "join_url": "https://meetings.feishu.cn/..." } 备注:可获取录制下载链接,AI 纪要仅限 GUI 查看
Gap:AI 纪要文本未通过 API 开放
Gap:API 暂不支持主动结束进行中的会议
任务
3/4 支持命令
mcp call task.task.create summary='修复登录 Bug' due='{"timestamp":"1735286400"}' 示例输出
{ "task_id": "tskXxx" } 命令
mcp call task.task.patch task_id=tskXxx completed_at=now
示例输出
{ "task_id": "tskXxx", "completed_at": "..." } 命令
mcp call task.task.collaborator.create task_id=tskXxx user_id=ou_xxx role_type=1
示例输出
{ "collaborator": { "user_id": "ou_xxx" } } Gap:API 仅支持单条创建,无 batch create 接口
邮件
2/3 支持命令
mcp call mail.user_mailbox.message.send to='bob@company.com' subject='Report' body='<p>See attached</p>'
示例输出
{ "message_id": "xxx" } 备注:支持 HTML body,可附带附件 token
命令
mcp call mail.user_mailbox.message.list user_mailbox_id=me page_size=20
示例输出
{ "items": [...] } Gap:飞书邮件 API 暂不支持删除操作
审批
4/5 支持命令
mcp call approval.instance.create approval_code=xxx form='[{"id":"widget1","value":"请假3天"}]' 输入参数
approval_code: 审批定义 code(管理员预先创建) form: 表单字段 JSON 数组
示例输出
{ "instance_code": "aPxxxxx" } 备注:approval_code 可通过 approval.approval.list 获取
命令
mcp call approval.instance.get instance_id=aPxxxxx
示例输出
{
"instance_code": "aPxxxxx",
"status": "PENDING",
"form": [...],
"timeline": [...]
}
命令
mcp call approval.instance.approve instance_id=aPxxxxx user_id=ou_xxx comment='同意'
示例输出
{ "instance_code": "aPxxxxx" } 备注:拒绝时调用 approval.instance.reject,需要审批人身份
命令
mcp call approval.instance.cancel instance_id=aPxxxxx user_id=ou_xxx
示例输出
{ "instance_code": "aPxxxxx" } 命令
mcp call approval.task.list user_id=ou_xxx page_size=20
备注:可获取当前用户所有待审批任务,但不支持跨部门批量操作
Gap:无法代他人查询审批列表,只能查自己
人事 / 假期
3/4 支持命令
mcp call attendance.leave_accrual_record.list user_id=ou_xxx leave_type_id=annual
示例输出
{
"accrual_records": [
{ "leave_type": "年假", "balance": 8.5, "unit": "天" }
]
}
命令
mcp call leave.user_daily_leave.apply leave_type_id=annual start_date=2026-05-01 end_date=2026-05-03 reason='个人事务'
输入参数
leave_type_id: 假期类型(annual/sick/personal...) start_date / end_date: YYYY-MM-DD reason: 请假事由
示例输出
{ "leave_request_id": "xxx", "status": "pending" } 命令
mcp call leave.user_leave_record.list user_id=ou_xxx start_date=2026-01-01 end_date=2026-12-31
示例输出
{ "records": [...] } Gap:入职流程仅限 HR 管理界面操作,API 未开放
OKR
4/5 支持命令
mcp call okr.okr.create period_id=xxx objective_content='提升 AI 功能覆盖率至 80%'
输入参数
period_id: OKR 周期 ID(季度/年) objective_content: O 的描述文字
示例输出
{ "okr_id": "xxx", "objective_id": "yyy" } 命令
mcp call okr.okr.objective.key_result.create okr_id=xxx objective_id=yyy content='发布 3 个新应用覆盖' score=0
示例输出
{ "key_result_id": "zzz" } 命令
mcp call okr.okr.objective.key_result.patch okr_id=xxx key_result_id=zzz score=60 progress_rate='{"percent":60}' 示例输出
{ "key_result_id": "zzz" } 命令
mcp call okr.okr.list user_id_list='["ou_xxx","ou_yyy"]' period_id=xxx
示例输出
{ "okr_list": [...] } Gap:OKR 对齐(父子关系)仅限 GUI 拖拽操作,API 未开放
Gap 总结 (12 个功能缺口)
消息 / IM › 撤回消息
CLI 暂未实现,API 支持但需代码调用
消息 / IM › 获取未读消息列表
未读标记需通过 im.message.patch 单独更新
云文档 › AI 智能创作
仅限 GUI,未开放 API
多维表格 / Bitable › 填写表单(表格视图)
表单提交仅限 Web GUI,API 无对应入口
日历 › 预约会议室
无专用 book-room 命令,需多步骤组合
视频会议 › 获取会议录制/纪要
AI 纪要文本未通过 API 开放
视频会议 › 强制结束会议
API 暂不支持主动结束进行中的会议
任务 › 批量导入任务
API 仅支持单条创建,无 batch create 接口
邮件 › 删除邮件
飞书邮件 API 暂不支持删除操作
审批 › 批量查询待办审批
无法代他人查询审批列表,只能查自己
人事 / 假期 › 发起入职流程
入职流程仅限 HR 管理界面操作,API 未开放
OKR › 设置 OKR 对齐关系
OKR 对齐(父子关系)仅限 GUI 拖拽操作,API 未开放