Feishu Bitable MCP

用于连接飞书多维表格（Bitable）任务板的 Model Context Protocol Server。

支持任何 MCP 兼容客户端（Kimi Code、Claude Code、Cursor、Windsurf 等）通过 stdio 传输读取、创建、更新、删除任务记录。

前置条件

• Node.js >= 18
• 飞书企业自建应用（已开通 Bitable 相关权限）
• 多维表格的 App Token 和 Table ID

安装

npm install -g feishu-bitable-mcp

或直接用 npx：

npx -y feishu-bitable-mcp

配置

在运行目录创建 .env：

FEISHU_APP_ID=cli_xxxxxxxxxxxx
FEISHU_APP_SECRET=xxxxxxxxxxxx
FEISHU_BITABLE_APP_TOKEN=xxxxxxxxxxxx
FEISHU_BITABLE_TABLE_ID=tblxxxxxxxxxx
FEISHU_DOMAIN=https://open.feishu.cn

在各客户端中的配置

Kimi Code

项目根目录 .kimi-code/mcp.json：

{
  "mcpServers": {
    "feishu-bitable": {
      "command": "npx",
      "args": ["-y", "feishu-bitable-mcp"]
    }
  }
}

Claude Code

claude mcp add feishu-bitable npx -y feishu-bitable-mcp

Cursor

~/.cursor/mcp.json：

{
  "mcpServers": {
    "feishu-bitable": {
      "command": "npx",
      "args": ["-y", "feishu-bitable-mcp"]
    }
  }
}

提供的工具

• list_tasks — 列出全部任务
• get_task — 获取单条任务详情
• create_task — 创建任务
• update_task — 更新任务字段
• delete_task — 删除任务

命令行模式（可选）

除了作为 MCP Server，也保留了独立 CLI：

feishu-bitable list
feishu-bitable get <record_id>
feishu-bitable create '<json_fields>'
feishu-bitable update <record_id> '<json_fields>'
feishu-bitable delete <record_id>

本地开发

cd packages/feishu-bitable-mcp
npm install
node src/cli.js list
npx @modelcontextprotocol/inspector node src/index.js

发布

npm publish --access public

许可

MIT