Feishu MCP Server

让 Claude 读取飞书文档、电子表格和多维表格。

安装

pnpm install

使用

1. 获取用户令牌

npx tsx src/oauth.ts -a <APP_ID> -s <APP_SECRET>

浏览器会打开飞书授权页面，登录授权后脚本会输出 user_access_token 和 refresh_token。

2. 配置 Claude MCP

在 Claude 的 MCP 配置中添加：

{
  "mcpServers": {
    "feishu": {
      "command": "npx",
      "args": [
        "tsx", "/absolute/path/to/src/index.ts",
        "-a", "<APP_ID>",
        "-s", "<APP_SECRET>",
        "-u", "<USER_ACCESS_TOKEN>",
        "-r", "<REFRESH_TOKEN>"
      ]
    }
  }
}

省略 -u -r 则使用 tenant token，只能访问应用本身有权限的资源。

可用工具

• get_document_info / read_document_content / read_document_blocks — 读取文档

• get_spreadsheet_info / list_sheets / read_spreadsheet_range — 读取电子表格

• list_bitable_tables / read_bitable_records — 读取多维表格

从 URL 提取 ID

凭据共享

• App ID / App Secret：应用级凭据，可通过私密渠道分享给团队成员。勿提交到 git。

• 用户令牌：个人凭据，每人需自行运行步骤 1 获取。勿共享。