npm package: @krisliu04/cc-feishu
Description: Claude Code MCP Server for Feishu/Lark — use Feishu docs, messages, bitable, and more from Claude Code
Latest version: 1.1.0

# cc-feishu

[Claude Code](https://claude.ai/claude-code) MCP Server for [Feishu/Lark](https://www.feishu.cn/) — operate docs, messages, tables, calendars, and more, directly from Claude Code.

[Claude Code](https://claude.ai/claude-code) 的飞书/Lark MCP Server —— 在 Claude Code 中直接操作飞书文档、消息、多维表格、日历等。

---

## Quick Start / 快速开始

### 1. Install / 安装

```bash
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](https://open.feishu.cn/app) → create or select an app → copy the App ID and App Secret.
>
> 前往[飞书开放平台](https://open.feishu.cn/app) → 创建或选择应用 → 复制 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`：

```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:

也可以使用环境变量：

```bash
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`，也可以手动添加：

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

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

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

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

---

## Requirements / 环境要求

- Node.js >= 18
- [Claude Code](https://claude.ai/claude-code) CLI

## License

MIT