Lark Mcp Server

飞书/Lark OpenAPI MCP

English | 中文

开发者文档检索 MCP

官方文档

故障排查

⚠️ Beta 版本提示：此工具目前处于 Beta 阶段。功能和 API 可能会发生变化，请及时关注版本发布。

这是飞书/Lark 官方 OpenAPI MCP（Model Context Protocol）工具，旨在帮助用户快速连接到飞书/Lark 平台，并实现 AI Agent 与飞书/Lark 之间的高效协作。该工具将飞书/Lark 开放平台 API 接口封装为 MCP 工具，使 AI 助手能够直接调用这些接口，实现文档处理、会话管理、日程安排等各种自动化场景。

准备工作

创建飞书/Lark 应用

使用 lark-mcp 工具前，需要创建飞书/Lark 应用：

1. 访问飞书开放平台或Lark 开放平台并登录
2. 点击“控制台”并创建新应用
3. 获取 App ID 和 App Secret，用于 API 身份验证
4. 根据使用场景为应用添加必要的权限
5. 如果需要以用户身份调用 API，请将 OAuth 2.0 重定向 URL 设置为 http://localhost:3000/callback

有关应用创建和配置的详细指南，请参阅飞书开放平台文档 - 创建应用。

安装 Node.js

使用 lark-mcp 工具前，需要安装 Node.js 环境。

使用官方安装程序（推荐）：

1. 访问 Node.js 网站
2. 下载并安装 LTS 版本
3. 安装后，在终端中验证：

node -v
npm -v

快速开始

与 Trae/Cursor/Claude 搭配使用

如需在 Trae、Cursor 或 Claude 等 AI 工具中集成飞书/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

# Login and get user access token
npx -y @larksuiteoapi/lark-mcp login -a cli_xxxx -s yyyyy
   
# Or optionally, login with specific OAuth scope - if not specified, all permissions will be authorized by default
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 在理解和使用这些 API 的过程中可能无法达到最佳效果。

开发集成

开发者可以参考与 Agent 集成的最简示例：lark-samples/mcp_quick_demo。

也可以参考 Lark 机器人集成示例：lark-samples/mcp_larkbot_demo/nodejs。

此示例演示如何将 MCP 能力集成到飞书/Lark 机器人中，通过机器人对话触发工具调用和消息发送，适用于将现有工具集成到 Bot 的场景。

高级配置

有关详细的配置选项和部署场景，请参阅我们的配置指南。

有关所有可用命令行参数及其用法的详细信息，请参阅命令行参考。

常见问题

• 常见问题解答（FAQ）
• 常见问题和用例

相关链接

• 飞书开放平台
• 开发文档：OpenAPI MCP
• Lark 国际开放平台
• 飞书开放平台 API 文档
• Node.js 网站
• npm 文档

反馈

欢迎提交问题，帮助改进此工具。如果您有任何疑问或建议，请在 GitHub 仓库中提出。