飞书开放平台MCP
项目介绍
飞书/Lark OpenAPI MCP
English | 中文
⚠️ 测试版通知: 此工具目前处于测试阶段。功能和API可能会发生变化，请关注版本发布更新。
这是飞书/Lark 官方 OpenAPI MCP（模型上下文协议）工具，旨在帮助用户快速连接到飞书/Lark 平台，并实现AI代理与飞书/Lark之间的高效协作。该工具封装了飞书/Lark 开放平台API接口作为MCP工具，允许AI助手直接调用这些接口并实现各种自动化场景，如文档处理、对话管理、日程安排等。
准备工作
创建飞书/Lark 应用
在使用 lark-mcp 工具之前，您需要创建一个飞书/Lark 应用：
- 访问 飞书开放平台 或 Lark 开放平台 并登录
- 点击“控制台”并创建一个新的应用
- 获取应用ID和应用密钥，用于API认证
- 根据您的使用场景添加必要的权限
- 如果需要以用户身份调用API，请设置OAuth 2.0重定向URL为http://localhost:3000/callback
关于详细的创建和配置应用指南，请参阅 飞书开放平台文档 - 创建应用。
安装 Node.js
在使用 lark-mcp 工具之前，您需要安装Node.js环境。
使用官方安装程序（推荐）：
- 访问 Node.js 网站
- 下载并安装 LTS 版本
- 安装完成后，在终端中验证：
node -v
npm -v
快速开始
与 Trae/Cursor/Claude 集成
要在AI工具如Trae、Cursor或Claude中集成飞书/Lark功能，请使用下方按钮进行安装。
或者在您的配置文件中添加以下内容：
{
"mcpServers": {
"lark-mcp": {
"command": "npx",
"args": [
"-y",
"@larksuiteoapi/lark-mcp",
"mcp",
"-a",
"<your_app_id>",
"-s",
"<your_app_secret>"
]
}
}
}
如果需要以用户身份访问API，您首先需要通过终端中的登录命令进行登录。请注意，您需要先在开发者控制台中配置应用程序的重定向URL，默认为http://localhost:3000/callback
# 登录并获取用户访问令牌
npx -y @larksuiteoapi/lark-mcp login -a cli_xxxx -s yyyyy
# 或可选地，使用特定的OAuth范围登录 - 如果未指定，则默认授权所有权限
npx -y @larksuiteoapi/lark-mcp login -a cli_xxxx -s yyyyy --scope offline_access docx:document
然后在您的配置文件中添加以下内容：
{
"mcpServers": {
"lark-mcp": {
"command": "npx",
"args": [
"-y",
"@larksuiteoapi/lark-mcp",
"mcp",
"-a",
"<your_app_id>",
"-s",
"<your_app_secret>",
"--oauth",
"--token-mode", "user_access_token"
]
}
}
}
注意：启用 --oauth 时，建议显式设置 --token-mode 为 user_access_token，这意味着使用用户访问令牌调用API，适用于访问用户资源或需要用户授权的场景（如读取个人文档、发送IM消息）。如果您保持默认 auto，某些API可能会回退到 tenant_access_token，这可能导致权限不足或无法访问用户私有数据。
域名配置
根据您的使用场景，lark-mcp 支持配置不同的域名环境：
飞书（中国版）：
- 默认使用
https://open.feishu.cn域名 - 适用于中国用户
Lark（国际版）：
- 使用
https://open.larksuite.com域名 - 适用于海外用户或Lark国际版
要切换到Lark国际版，可以在配置中添加 --domain 参数：
{
"mcpServers": {
"lark-mcp": {
"command": "npx",
"args": [
"-y",
"@larksuiteoapi/lark-mcp",
"mcp",
"-a",
"<your_app_id>",
"-s",
"<your_app_secret>",
"--domain",
"https://open.larksuite.com"
]
}
}
}
💡 提示：确保您的应用是在对应的域名环境的开放平台上创建的。国际版应用不能用于飞书中国版，反之亦然。
自定义API配置
⚠️ 文件上传/下载：文件上传和下载操作尚未支持
⚠️ 文档编辑：不支持直接编辑飞书云文档（仅支持导入和阅读）
默认情况下，MCP服务启用了常见API。要启用其他工具或仅特定API或预设，您可以使用MCP客户端配置（JSON）中的 -t 参数指定它们：
{
"mcpServers": {
"lark-mcp": {
"command": "npx",
"args": [
"-y",
"@larksuiteoapi/lark-mcp",
"mcp",
"-a", "<your_app_id>",
"-s", "<your_app_secret>",
"-t", "im.v1.message.create,im.v1.message.list,im.v1.chat.create,preset.calendar.default"
]
}
}
}
有关所有预设工具集合的详细信息以及每个预设包含哪些工具，请参阅 预设工具集合参考。
所有支持的飞书/Lark工具的完整列表可以在 tools.md 中找到。
⚠️ 注意：非预设API未经兼容性测试，AI在理解和使用过程中可能表现不佳。
开发者集成
开发者可以参考最小示例进行代理集成：lark-samples/mcp_quick_demo。
您也可以参考Lark机器人集成示例：lark-samples/mcp_larkbot_demo/nodejs。
此示例展示了如何将MCP能力集成到飞书/Lark机器人中，通过机器人对话触发工具调用和消息发送，适用于将现有工具集成到Bot的场景。
高级配置
对于详细的配置选项和部署场景，请参阅我们的 配置指南。
有关所有可用命令行参数及其用法的详细信息，请参阅 命令行参考。
常见问题
相关链接
反馈
欢迎提出问题来改进此工具。如果您有任何疑问或建议，请在GitHub仓库中提出。