cc-feishu

Claude Code MCP Server for Feishu/Lark — operate docs, messages, tables, calendars, and more, directly from Claude Code.

Claude Code 的飞书/Lark MCP Server —— 在 Claude Code 中直接操作飞书文档、消息、多维表格、日历等。

Quick Start / 快速开始

1. Install / 安装

npx @krisliu04/cc-feishu setup

This registers cc-feishu as an MCP server in your Claude Code config. One command, done.

一条命令完成注册，将 cc-feishu 添加到 Claude Code 的 MCP 配置中。

2. First Use / 首次使用

Tell Claude your Feishu app credentials — it will connect and save them automatically:

把飞书应用凭证告诉 Claude，它会自动连接并保存：

You:  连接飞书，appId 是 cli_xxx，appSecret 是 yyy
CC:   calls feishu_connect({ appId: "cli_xxx", appSecret: "yyy" })
      → Connected. Credentials saved to ~/.cc-feishu/config.yaml

3. Every Time After / 以后每次

Just say "connect to Feishu":

只需说"连接飞书"：

You:  连接飞书
CC:   calls feishu_connect()
      → Connected (using saved config)

Where to get credentials / 凭证从哪来？

Go to Feishu Open Platform → create or select an app → copy the App ID and App Secret.

前往飞书开放平台 → 创建或选择应用 → 复制 App ID 和 App Secret。

Features / 功能

Documents / 文档 (feishu_doc)

Read, write, append, and structure Feishu documents. Supports block-level operations, tables, images, and file uploads.

读写飞书文档，支持块级操作、表格、图片和文件上传。

| Action | Description | |---|---| | read | Read document content / 读取文档内容 | | write | Overwrite document / 覆盖写入文档 | | append | Append content / 追加内容 | | insert | Insert content after a block / 在指定块后插入 | | create | Create new document / 创建新文档 | | list_blocks | List all blocks / 列出所有块 | | get_block / update_block / delete_block | Block CRUD / 块的增删改 | | create_table / write_table_cells / create_table_with_values | Table operations / 表格操作 | | insert_table_row / insert_table_column / delete_table_rows / delete_table_columns / merge_table_cells | Table structure / 表格结构操作 | | upload_image / upload_file | Upload media / 上传图片和文件 | | color_text | Color text blocks / 文本着色 |

Wiki / 知识库 (feishu_wiki)

Manage knowledge base spaces and nodes.

管理知识库空间和节点。

| Action | Description | |---|---| | spaces | List all wiki spaces / 列出知识空间 | | nodes | List nodes in a space / 列出空间下的节点 | | get | Get node details / 获取节点详情 | | create | Create a wiki node / 创建知识库节点 | | move / rename | Move or rename a node / 移动或重命名节点 |

Bitable / 多维表格 (feishu_bitable_*)

Full CRUD for Feishu's multidimensional tables — fields, records, and apps.

多维表格的完整增删改查 —— 字段、记录、应用。

| Tool | Description | |---|---| | feishu_bitable_get_meta | Parse URL, get app_token & table list / 解析 URL，获取表信息 | | feishu_bitable_list_fields | List columns with types / 列出字段及类型 | | feishu_bitable_list_records | List rows (paginated) / 分页列出记录 | | feishu_bitable_get_record | Get a single record / 获取单条记录 | | feishu_bitable_create_record | Create a row / 新增记录 | | feishu_bitable_update_record | Update a row / 更新记录 | | feishu_bitable_create_app | Create a new Bitable / 创建新多维表格 | | feishu_bitable_create_field | Add a column / 新增字段 |

Messaging / 即时消息 (feishu_im)

Send, reply, update, and retrieve messages. Supports text, rich text, interactive cards, images, and files.

发送、回复、更新和查询消息。支持文本、富文本、交互卡片、图片和文件。

| Action | Description | |---|---| | send_message | Send a message / 发送消息 | | reply_message | Reply to a message / 回复消息 | | update_message | Update a sent message / 更新已发消息 | | get_message / list_messages | Retrieve messages / 获取消息 | | send_card | Send interactive card / 发送交互卡片 | | upload_image / upload_file | Upload media for messaging / 上传图片或文件 |

Calendar / 日历 (feishu_calendar)

Manage calendars, events, and attendees.

管理日历、日程和参与者。

| Action | Description | |---|---| | list_calendars | List calendars / 列出日历 | | list_events / get_event | Read events / 查询日程 | | create_event / update_event / delete_event | Event CRUD / 日程增删改 | | list_attendees / create_attendees | Manage attendees / 管理参与者 |

Tasks / 任务 (feishu_task)

Task management via Feishu Task API v2.

通过飞书任务 API v2 管理任务。

| Action | Description | |---|---| | list_tasklists | List task lists / 列出任务清单 | | list_tasks | List tasks in a list / 列出任务 | | create_task / get_task / update_task | Task CRUD / 任务增删改 | | complete_task | Mark task complete / 完成任务 |

Contacts / 通讯录 (feishu_contact)

Search users and browse the org structure.

搜索用户、浏览组织架构。

| Action | Description | |---|---| | get_user / search_user | Find users / 查找用户 | | list_departments / get_department | Browse departments / 浏览部门 | | list_department_users | List users in a department / 列出部门成员 |

Chat / 群组 (feishu_chat)

Get chat group info and members.

获取群组信息和成员列表。

| Action | Description | |---|---| | info | Get chat details / 获取群组信息 | | members | List chat members / 列出群组成员 |

Drive / 云空间 (feishu_drive)

Manage files and folders in Feishu Drive.

管理飞书云空间中的文件和文件夹。

| Action | Description | |---|---| | list | List files in a folder / 列出文件 | | info | Get file/folder info / 获取文件信息 | | create_folder | Create a folder / 创建文件夹 | | move / delete | Move or delete / 移动或删除 |

Permissions / 权限 (feishu_perm)

Manage document access permissions.

管理文档访问权限。

| Action | Description | |---|---| | list | List current permissions / 查看权限列表 | | add | Grant access / 添加权限 | | remove | Revoke access / 移除权限 |

Configuration / 配置

Zero Config / 零配置

cc-feishu works with no config file. Just pass credentials via feishu_connect and they'll be saved to ~/.cc-feishu/config.yaml automatically.

cc-feishu 支持零配置启动。通过 feishu_connect 传入凭证后会自动保存到 ~/.cc-feishu/config.yaml。

Config File / 配置文件

For advanced setups (multiple bots, bridge mode), create ~/.cc-feishu/config.yaml:

如需高级配置（多 Bot、Bridge 模式），手动创建 ~/.cc-feishu/config.yaml：

defaultBot: my-bot

bots:
  my-bot:
    appId: cli_xxx
    appSecret: xxx
    domain: feishu    # or "lark" for international

  another-bot:
    appId: cli_yyy
    appSecret: yyy
    domain: lark

Environment Variables / 环境变量

Alternatively, set environment variables:

也可以使用环境变量：

export FEISHU_APP_ID=cli_xxx
export FEISHU_APP_SECRET=xxx
export FEISHU_DOMAIN=feishu   # optional, defaults to "feishu"

Multi-Bot / 多 Bot

When multiple bots are configured, specify which one to connect:

配置多个 Bot 时，连接时指定名称：

You:  连接飞书 bot another-bot
CC:   calls feishu_connect({ bot: "another-bot" })

cc-feishu uses PID-based locking to prevent two Claude Code sessions from using the same bot simultaneously.

cc-feishu 使用基于 PID 的锁机制，防止两个 Claude Code 会话同时使用同一个 Bot。

Manual Setup / 手动安装

If you prefer not to use npx cc-feishu setup, add it manually:

如果不想用 npx cc-feishu setup，也可以手动添加：

claude mcp add cc-feishu -s user -- npx -y @krisliu04/cc-feishu

Or edit ~/.claude/.mcp.json directly:

或者直接编辑 ~/.claude/.mcp.json：

{
  "mcpServers": {
    "cc-feishu": {
      "command": "npx",
      "args": ["-y", "@krisliu04/cc-feishu"]
    }
  }
}

Requirements / 环境要求

• Node.js >= 18
• Claude Code CLI

License

MIT