中文 | English
⚠️ Beta版本提示：当前工具处于Beta版本阶段，功能和API可能会有变更，请密切关注版本更新。
飞书/Lark官方 OpenAPI MCP（Model Context Protocol）工具，旨在帮助用户快速连接飞书平台并实现 AI Agent 与飞书的高效协作。该工具将飞书开放平台的 API 接口封装为 MCP 工具，使 AI 助手能够直接调用这些接口，实现文档处理、会话管理、日历安排等多种自动化场景。
在使用lark-mcp工具前，您需要先创建一个飞书应用：
- 访问飞书开放平台并登录
- 点击"开发者后台"，创建一个新应用
- 获取应用的App ID和App Secret，这将用于API认证
- 根据您的使用场景，为应用添加所需的权限
- 如需以用户身份调用API，请设置OAuth 2.0重定向URL为 http://localhost:3000/callback
详细的应用创建和配置指南，请参考飞书开放平台文档 - 创建应用。
在使用lark-mcp工具之前，您需要先安装Node.js环境。
使用官方安装包（推荐）：
- 访问Node.js官网
- 下载并安装LTS版本
- 安装完成后，打开终端验证：
node -v npm -v
如需在Trae、Cursor等AI工具中集成飞书/Lark功能，你可以通过下方按钮安装，将 app_id 和 app_secret 填入安装弹窗或客户端配置 JSON 的 args 中：
也可以直接在 MCP Client 的配置文件中添加以下内容（JSON），客户端会按配置启动 lark-mcp：
{
"mcpServers": {
"lark-mcp": {
"command": "npx",
"args": [
"-y",
"@larksuiteoapi/lark-mcp",
"mcp",
"-a",
"<your_app_id>",
"-s",
"<your_app_secret>"
]
}
}
}
如需使用用户身份访问 API：
- 在终端运行
login（会保存令牌，后续客户端可直接复用）。 - 在 MCP Client 配置中加入
--oauth。
注意需要先在开发者后台配置应用的重定向 URL，默认是 http://localhost:3000/callback。
npx -y @larksuiteoapi/lark-mcp login -a cli_xxxx -s yyyyy
然后在 MCP Client 中启用 --oauth
{
"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，可能在AI推理使用 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"
]
}
}
}
💡 提示：确保您的应用已在对应域名环境的开放平台创建。国际版应用无法在飞书中国版使用，反之亦然。
⚠️ 文件上传下载：暂不支持文件的上传和下载操作
⚠️ 云文档编辑：暂不支持直接编辑飞书云文档内容（仅支持导入和读取）
默认情况下，MCP 服务启用常用 API。如需启用其他工具或仅启用特定 API 或 preset，推荐在 MCP Client 配置（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在理解使用的过程中可能效果不理想
开发者可参考在 Agent 中集成的最小示例：lark-samples/mcp_quick_demo。
另外可参考 Lark 机器人集成示例：lark-samples/mcp_larkbot_demo/nodejs。
该示例展示如何将 MCP 能力集成到飞书/Lark 机器人中，通过机器人会话触发工具调用与消息收发，适用于将已有工具接入 Bot 的场景。
更详细的配置选项和部署场景，请参考我们的配置指南。
关于所有可用命令行参数及其使用方法的详细信息，请参考命令行参考文档。
欢迎提交Issues来帮助改进这个工具。如有问题或建议，请在GitHub仓库中提出。
