@danyow/lark-mcp 0.5.1

package/docs/recall-mcp/README_ZH.md

@@ -0,0 +1,137 @@
+# 飞书/Lark 开放平台开发文档检索 MCP
+
+[![npm version](https://img.shields.io/npm/v/@larksuiteoapi/lark-mcp.svg)](https://www.npmjs.com/package/@larksuiteoapi/lark-mcp)
+[![npm downloads](https://img.shields.io/npm/dm/@larksuiteoapi/lark-mcp.svg)](https://www.npmjs.com/package/@larksuiteoapi/lark-mcp)
+[![Node.js Version](https://img.shields.io/node/v/@larksuiteoapi/lark-mcp.svg)](https://nodejs.org/)
+
+中文 | [English](./README.md)
+
+> **⚠️ Beta版本提示**：当前工具处于Beta版本阶段，功能和API可能会有变更，请密切关注版本更新。
+
+这是飞书/Lark官方 开放平台开发文档检索 MCP（Model Context Protocol）工具，旨在帮助用户输入自身诉求后迅速检索到自己需要的开发文档，帮助开发者在AI IDE中编写与飞书集成的代码。也可搭配 [飞书/Lark OpenAPI MCP](../../README_ZH.md) 来让 AI 助手运行自动化场景
+
+>**说明**： 开放平台开发文档检索，检索范围是 [开发文档](https://open.feishu.cn/document/home/index) 下所有的开发指南、开发教程、服务端 API、客户端 API，帮助用户迅速检索到对应的 OpenApi 或者其他开发文档，非「飞书云文档」的检索。
+
+## 使用准备
+
+### 安装Node.js
+
+在使用lark-mcp工具之前，您需要先安装Node.js环境。如已安装过 Node.js，可以跳过本步骤
+1. **使用Homebrew安装（推荐）**：
+
+   ```bash
+   brew install node
+   ```
+
+2. **使用官方安装包**：
+   - 访问[Node.js官网](https://nodejs.org/)
+   - 下载并安装LTS版本
+   - 安装完成后，打开终端验证：
+     ```bash
+     node -v
+     npm -v
+     ```
+
+#### Windows安装Node.js
+
+1. **使用官方安装包**：
+
+   - 访问[Node.js官网](https://nodejs.org/)
+   - 下载并运行Windows安装程序（.msi文件）
+   - 按照安装向导操作，完成安装
+   - 安装完成后，打开命令提示符验证：
+     ```bash
+     node -v
+     npm -v
+     ```
+
+2. **使用nvm-windows**：
+   - 下载[nvm-windows](https://github.com/coreybutler/nvm-windows/releases)
+   - 安装nvm-windows
+   - 使用nvm安装Node.js：
+     ```bash
+     nvm install latest
+     nvm use <版本号>
+     ```
+
+## 安装
+
+全局安装lark-mcp工具：
+
+```bash
+npm install -g @larksuiteoapi/lark-mcp
+```
+
+## 使用指南
+
+### 在Trae/Cursor/Claude中使用
+如需在Trae/Cursor或Claude等AI工具中集成飞书/Lark功能，你可以通过下方按钮安装到对应的工具：
+
+[![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/install-mcp?name=lark_open_doc_search&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBsYXJrc3VpdGVvYXBpL2xhcmstbWNwIiwicmVjYWxsLWRldmVsb3Blci1kb2N1bWVudHMiXX0=)
+
+[![Install MCP Server](../../assets/trae-cn.svg)](trae-cn://trae.ai-ide/mcp-import?source=lark&type=stdio&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBsYXJrc3VpdGVvYXBpL2xhcmstbWNwIiwicmVjYWxsLWRldmVsb3Blci1kb2N1bWVudHMiXX0=)  [![Install MCP Server](../../assets/trae.svg)](trae://trae.ai-ide/mcp-import?source=lark&type=stdio&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBsYXJrc3VpdGVvYXBpL2xhcmstbWNwIiwicmVjYWxsLWRldmVsb3Blci1kb2N1bWVudHMiXX0=)
+
+也可以在配置文件中添加以下内容：
+
+```json
+{
+  "mcpServers": {
+    "lark-mcp": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@larksuiteoapi/lark-mcp",
+        "recall-developer-documents",
+      ]
+    }
+  }
+}
+```
+
+### 高级配置
+
+#### 命令行参数说明
+
+`lark-mcp recall-developer-documents`工具提供了多种命令行参数，以便您灵活配置MCP服务：
+
+| 参数 | 简写 | 描述 | 示例 |
+|------|------|------|------|
+| `--mode` | `-m` | 传输模式，可选值为stdio、streamable或sse，默认为stdio | `-m sse` |
+| `--host` |  | SSE\Streamable模式下的监听主机，默认为localhost | `--host 0.0.0.0` |
+| `--port` | `-p` | SSE\Streamable模式下的监听端口，默认为3000 | `-p 3000` |
+| `--version` | `-V` | 显示版本号 | `-V` |
+| `--help` | `-h` | 显示帮助信息 | `-h` |
+
+#### 参数使用示例
+
+1. **传输模式**：
+
+    recall-developer-documents 支持两种传输模式：
+
+    1. **stdio模式（默认/推荐）**：适用于与Cursor或Claude等AI工具集成，通过标准输入输出流进行通信。
+    ```bash
+    lark-mcp recall-developer-documents -m stdio
+    ```
+
+    2. **SSE模式**：提供基于Server-Sent Events的HTTP接口，适用于Web应用或需要网络接口的场景。
+
+    ```bash
+    # 默认只监听localhost
+    lark-mcp recall-developer-documents -m sse -p 3000
+
+    # 监听所有网络接口（允许远程访问）
+    lark-mcp recall-developer-documents -m sse --host 0.0.0.0 -p 3000
+    ```
+
+    启动后，SSE端点将可在 `http://<host>:<port>/sse` 访问。
+
+## 相关链接
+
+- [飞书开放平台](https://open.feishu.cn/)
+- [Lark国际版开放平台](https://open.larksuite.com/)
+- [Node.js官网](https://nodejs.org/)
+- [npm文档](https://docs.npmjs.com/)
+
+## 反馈
+
+欢迎提交Issues来帮助改进这个工具。如有问题或建议，请在GitHub仓库中提出。

package/docs/reference/cli/cli-zh.md

@@ -0,0 +1,92 @@
+# 命令行参考
+
+本文档提供了 lark-mcp 工具所有命令行参数的详细说明。
+
+## 目录
+
+- [lark-mcp login](#lark-mcp-login)
+- [lark-mcp logout](#lark-mcp-logout)  
+- [lark-mcp mcp](#lark-mcp-mcp)
+
+## lark-mcp login
+
+`lark-mcp login` 命令用于进行用户身份认证，获取用户访问令牌以访问用户的个人数据。
+
+### 参数说明
+
+| 参数 | 简写 | 描述 | 示例 |
+|------|------|------|------|
+| `--app-id` | `-a` | 飞书/Lark应用的App ID | `-a cli_xxxx` |
+| `--app-secret` | `-s` | 飞书/Lark应用的App Secret | `-s xxxx` |
+| `--domain` | `-d` | 飞书/Lark API域名，默认为https://open.feishu.cn | `-d https://open.larksuite.com` |
+| `--host` |  | 监听主机，默认为localhost | `--host localhost` |
+| `--port` | `-p` | 监听端口，默认为3000 | `-p 3000` |
+| `--scope` |  | 指定授权用户访问令牌的OAuth权限范围，默认为应用开通的全部权限，用空格或者逗号分割 | `--scope offline_access docx:document` |
+
+### 使用示例
+
+```bash
+# 基础登录
+npx -y @larksuiteoapi/lark-mcp login -a cli_xxxx -s your_secret
+
+# 指定特定的OAuth权限范围登录
+npx -y @larksuiteoapi/lark-mcp login -a cli_xxxx -s your_secret --scope offline_access docx:document
+
+# 使用自定义域名登录（适用于Lark国际版）
+npx -y @larksuiteoapi/lark-mcp login -a cli_xxxx -s your_secret -d https://open.larksuite.com
+```
+
+## lark-mcp logout
+
+`lark-mcp logout` 命令用于清除本地存储的用户访问令牌。
+
+### 参数说明
+
+| 参数 | 简写 | 描述 | 示例 |
+|------|------|------|------|
+| `--app-id` | `-a` | 飞书/Lark应用的App ID，可选。指定则只清除该应用的令牌，不指定则清除所有应用的令牌 | `-a cli_xxxx` |
+
+### 功能说明
+
+此命令用于清除本地存储的用户访问令牌。如果指定了 `--app-id` 参数，则只清除该应用的用户访问令牌；如果不指定，则清除所有应用的用户访问令牌。
+
+### 使用示例
+
+```bash
+# 清除特定应用的令牌
+npx -y @larksuiteoapi/lark-mcp logout -a cli_xxxx
+
+# 清除所有应用的令牌
+npx -y @larksuiteoapi/lark-mcp logout
+```
+
+## lark-mcp mcp
+
+`lark-mcp mcp` 工具提供了多种命令行参数，以便您灵活配置MCP服务。
+
+### 参数说明
+
+| 参数 | 简写 | 描述 | 示例 |
+|------|------|------|------|
+| `--app-id` | `-a` | 飞书/Lark应用的App ID | `-a cli_xxxx` |
+| `--app-secret` | `-s` | 飞书/Lark应用的App Secret | `-s xxxx` |
+| `--domain` | `-d` | 飞书/Lark API域名，默认为https://open.feishu.cn | `-d https://open.larksuite.com` |
+| `--tools` | `-t` | 需要启用的API工具列表，用空格或者逗号分割 | `-t im.v1.message.create,im.v1.chat.create` |
+| `--tool-name-case` | `-c` | 工具注册名称的命名格式，可选值为snake、camel、dot或kebab，默认为snake | `-c camel` |
+| `--language` | `-l` | 工具语言，可选值为zh或en，默认为en | `-l zh` |
+| `--user-access-token` | `-u` | 用户访问令牌，用于以用户身份调用API | `-u u-xxxx` |
+| `--token-mode` |  | API令牌类型，可选值为auto、tenant_access_token或user_access_token，默认为auto | `--token-mode user_access_token` |
+| `--oauth` |  | 开启 MCP Auth Server 获取user_access_token，且当Token失效时自动要求用户重新登录(Beta) | `--oauth` |
+| `--scope` |  | 指定授权用户访问令牌的OAuth权限范围，默认为应用开通的全部权限，用空格或者逗号分割 | `--scope offline_access docx:document` |
+| `--mode` | `-m` | 传输模式，可选值为stdio、streamable或sse，默认为stdio | `-m streamable` |
+| `--host` |  | SSE\Streamable模式下的监听主机，默认为localhost | `--host 0.0.0.0` |
+| `--port` | `-p` | SSE\Streamable模式下的监听端口，默认为3000 | `-p 3000` |
+| `--config` |  | 配置文件路径，支持JSON格式 | `--config ./config.json` |
+| `--version` | `-V` | 显示版本号 | `-V` |
+| `--help` | `-h` | 显示帮助信息 | `-h` |
+
+## 相关文档
+
+- [配置指南](../../usage/configuration/configuration-zh.md)
+- [工具参考](../tool-presets/tools-zh.md)
+- [故障排除](../../troubleshooting/faq-zh.md)

package/docs/reference/cli/cli.md

@@ -0,0 +1,92 @@
+# Command Line Reference
+
+This document provides detailed information about all command line parameters available for the lark-mcp tool.
+
+## Table of Contents
+
+- [lark-mcp login](#lark-mcp-login)
+- [lark-mcp logout](#lark-mcp-logout)  
+- [lark-mcp mcp](#lark-mcp-mcp)
+
+## lark-mcp login
+
+The `lark-mcp login` command is used to authenticate with user identity and obtain user access tokens for accessing user's personal data.
+
+### Parameters
+
+| Parameter | Short | Description | Example |
+|------|------|------|------|
+| `--app-id` | `-a` | Feishu/Lark application App ID | `-a cli_xxxx` |
+| `--app-secret` | `-s` | Feishu/Lark application App Secret | `-s xxxx` |
+| `--domain` | `-d` | Feishu/Lark API domain, default is https://open.feishu.cn | `-d https://open.larksuite.com` |
+| `--host` |  | Host to listen, default is localhost | `--host localhost` |
+| `--port` | `-p` | Port to listen, default is 3000 | `-p 3000` |
+| `--scope` |  | Specify OAuth scope for user access token, default is all permissions granted to the app, separated by spaces or commas | `--scope offline_access docx:document` |
+
+### Usage Examples
+
+```bash
+# Basic login
+npx -y @larksuiteoapi/lark-mcp login -a cli_xxxx -s your_secret
+
+# Login with specific OAuth scope
+npx -y @larksuiteoapi/lark-mcp login -a cli_xxxx -s your_secret --scope offline_access docx:document
+
+# Login with custom domain (for Lark international)
+npx -y @larksuiteoapi/lark-mcp login -a cli_xxxx -s your_secret -d https://open.larksuite.com
+```
+
+## lark-mcp logout
+
+The `lark-mcp logout` command is used to clear locally stored user access tokens.
+
+### Parameters
+
+| Parameter | Short | Description | Example |
+|------|------|------|------|
+| `--app-id` | `-a` | Feishu/Lark application App ID, optional. If specified, only clears the token for this app; if not specified, clears tokens for all apps | `-a cli_xxxx` |
+
+### Description
+
+This command is used to clear locally stored user access tokens. If the `--app-id` parameter is specified, it only clears the user access token for that application; if not specified, it clears user access tokens for all applications.
+
+### Usage Examples
+
+```bash
+# Clear tokens for a specific app
+npx -y @larksuiteoapi/lark-mcp logout -a cli_xxxx
+
+# Clear tokens for all apps
+npx -y @larksuiteoapi/lark-mcp logout
+```
+
+## lark-mcp mcp
+
+The `lark-mcp mcp` tool provides various command line parameters to flexibly configure the MCP service.
+
+### Parameters
+
+| Parameter | Short | Description | Example |
+|------|------|------|------|
+| `--app-id` | `-a` | Feishu/Lark application App ID | `-a cli_xxxx` |
+| `--app-secret` | `-s` | Feishu/Lark application App Secret | `-s xxxx` |
+| `--domain` | `-d` | Feishu/Lark API domain, default is https://open.feishu.cn | `-d https://open.larksuite.com` |
+| `--tools` | `-t` | List of API tools to enable, separated by spaces or commas | `-t im.v1.message.create,im.v1.chat.create` |
+| `--tool-name-case` | `-c` | Tool name format, options are snake, camel, dot, or kebab, default is snake | `-c camel` |
+| `--language` | `-l` | Tools language, options are zh or en, default is en | `-l zh` |
+| `--user-access-token` | `-u` | User access token for calling APIs as a user | `-u u-xxxx` |
+| `--token-mode` |  | API token type, options are auto, tenant_access_token, or user_access_token, default is auto | `--token-mode user_access_token` |
+| `--oauth` |  | Enable MCP Auth Server to get user_access_token and auto request user login when token expires (Beta) | `--oauth` |
+| `--scope` |  | Specify OAuth scope for user access token, default is all permissions granted to the app, separated by spaces or commas | `--scope offline_access docx:document` |
+| `--mode` | `-m` | Transport mode, options are stdio, streamable, or sse, default is stdio | `-m streamable` |
+| `--host` |  | Listening host in SSE/Streamable mode, default is localhost | `--host 0.0.0.0` |
+| `--port` | `-p` | Listening port in SSE/Streamable mode, default is 3000 | `-p 3000` |
+| `--config` |  | Configuration file path, supports JSON format | `--config ./config.json` |
+| `--version` | `-V` | Display version number | `-V` |
+| `--help` | `-h` | Display help information | `-h` |
+
+## Related Documentation
+
+- [Configuration Guide](../../usage/configuration/configuration.md)
+- [Tools Reference](../tool-presets/tools-en.md)
+- [Troubleshooting](../../troubleshooting/faq.md)

package/docs/reference/tool-presets/presets-zh.md

@@ -0,0 +1,120 @@
+# 预设工具集参考
+
+本文档提供了 lark-mcp 中所有可用预设工具集的详细信息。预设是为特定用例预定义的工具集，可以一起启用。
+
+## 概述
+
+如无特殊需求，可保持默认 preset 即可使用常用功能。需要精细控制或了解完整列表时，可参考下面的预设表格。
+
+## 如何使用预设
+
+要使用预设，请在 `-t` 参数中指定：
+
+```json
+{
+  "mcpServers": {
+    "lark-mcp": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@larksuiteoapi/lark-mcp",
+        "mcp",
+        "-a", "<your_app_id>",
+        "-s", "<your_app_secret>",
+        "-t", "preset.light"
+      ]
+    }
+  }
+}
+```
+
+您也可以将预设与单个工具组合：
+
+```json
+{
+  "mcpServers": {
+    "lark-mcp": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@larksuiteoapi/lark-mcp",
+        "mcp",
+        "-a", "<your_app_id>",
+        "-s", "<your_app_secret>",
+        "-t", "preset.light,im.v1.message.create"
+      ]
+    }
+  }
+}
+```
+
+## 预设工具集详表
+
+| 工具名称 | 功能描述 | preset.light | preset.default (默认) | preset.im.default | preset.base.default | preset.base.batch | preset.doc.default | preset.task.default | preset.calendar.default |
+| --- | --- | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: |
+| im.v1.chat.create | 创建群 | | ✓ | ✓ | | | | | |
+| im.v1.chat.list | 获取群列表 | | ✓ | ✓ | | | | | |
+| im.v1.chat.search | 搜索群 | ✓ | | | | | | | |
+| im.v1.chatMembers.get | 获取群成员 | | ✓ | ✓ | | | | | |
+| im.v1.message.create | 发送消息 | ✓ | ✓ | ✓ | | | | | |
+| im.v1.message.list | 获取消息列表 | ✓ | ✓ | ✓ | | | | | |
+| bitable.v1.app.create | 创建多维表格 | | ✓ | | ✓ | ✓ | | | |
+| bitable.v1.appTable.create | 创建多维表格数据表 | | ✓ | | ✓ | ✓ | | | |
+| bitable.v1.appTable.list | 获取多维表格数据表列表 | | ✓ | | ✓ | ✓ | | | |
+| bitable.v1.appTableField.list | 获取多维表格数据表字段列表 | | ✓ | | ✓ | ✓ | | | |
+| bitable.v1.appTableRecord.search | 搜索多维表格数据表记录 | ✓ | ✓ | | ✓ | ✓ | | | |
+| bitable.v1.appTableRecord.create | 创建多维表格数据表记录 | | ✓ | | ✓ | | | | |
+| bitable.v1.appTableRecord.batchCreate | 批量创建多维表格数据表记录 | ✓ | | | | ✓ | | | |
+| bitable.v1.appTableRecord.update | 更新多维表格数据表记录 | | ✓ | | ✓ | | | | |
+| bitable.v1.appTableRecord.batchUpdate | 批量更新多维表格数据表记录 | | | | | ✓ | | | |
+| docx.v1.document.rawContent | 获取文档内容 | ✓ | ✓ | | | | ✓ | | |
+| docx.builtin.import | 导入文档 | ✓ | ✓ | | | | ✓ | | |
+| docx.builtin.search | 搜索文档 | ✓ | ✓ | | | | ✓ | | |
+| drive.v1.permissionMember.create | 添加协作者权限 | | ✓ | | | | ✓ | | |
+| wiki.v2.space.getNode | 获取知识库节点 | ✓ | ✓ | | | | ✓ | | |
+| wiki.v1.node.search | 搜索知识库节点 | | ✓ | | | | ✓ | | |
+| contact.v3.user.batchGetId | 批量获取用户ID | ✓ | ✓ | | | | | | |
+| task.v2.task.create | 创建任务 | | | | | | | ✓ | |
+| task.v2.task.patch | 修改任务 | | | | | | | ✓ | |
+| task.v2.task.addMembers | 添加任务成员 | | | | | | | ✓ | |
+| task.v2.task.addReminders | 添加任务提醒 | | | | | | | ✓ | |
+| calendar.v4.calendarEvent.create | 创建日历事件 | | | | | | | | ✓ |
+| calendar.v4.calendarEvent.patch | 修改日历事件 | | | | | | | | ✓ |
+| calendar.v4.calendarEvent.get | 获取日历事件 | | | | | | | | ✓ |
+| calendar.v4.freebusy.list | 查询忙闲状态 | | | | | | | | ✓ |
+| calendar.v4.calendar.primary | 获取主日历 | | | | | | | | ✓ |
+
+> **说明**：表格中"✓"表示该工具包含在对应的预设工具集中。使用`-t preset.xxx`参数时，会启用该列标有"✓"的工具。
+
+## 预设说明
+
+### preset.light
+最小化预设，仅包含基本消息和文档操作的核心工具。适合轻量级集成。
+
+### preset.default（默认）
+默认预设，包含消息、文档、数据库和协作等常用工具。推荐大多数用户使用。
+
+### preset.im.default
+专注于即时消息功能，包括群聊创建、成员管理和消息处理。
+
+### preset.base.default
+包含多维表格的基础数据库操作，适用于数据管理场景。
+
+### preset.base.batch
+专门用于多维表格数据的批量操作，适合批量数据处理。
+
+### preset.doc.default
+以文档为中心的预设，包括文档读取、导入、搜索和协作功能。
+
+### preset.task.default
+任务管理预设，用于创建、修改和管理带有提醒和成员的任务。
+
+### preset.calendar.default
+日历管理预设，用于创建、修改事件和查询可用性。
+
+## 相关文档
+
+- [主要文档](../../../README_ZH.md)
+- [工具参考](./tools-zh.md)
+- [配置指南](../../usage/configuration/configuration-zh.md)
+- [命令行参考](../cli/cli-zh.md)

package/docs/reference/tool-presets/presets.md

@@ -0,0 +1,120 @@
+# Preset Tool Collections Reference
+
+This document provides detailed information about all preset tool collections available in lark-mcp. Presets are predefined sets of tools that can be enabled together for specific use cases.
+
+## Overview
+
+If you have no special requirements, you can keep the default preset to use common functions. When you need fine control or want to understand the complete list, please refer to the preset table below.
+
+## How to Use Presets
+
+To use a preset, specify it in the `-t` parameter:
+
+```json
+{
+  "mcpServers": {
+    "lark-mcp": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@larksuiteoapi/lark-mcp",
+        "mcp",
+        "-a", "<your_app_id>",
+        "-s", "<your_app_secret>",
+        "-t", "preset.light"
+      ]
+    }
+  }
+}
+```
+
+You can also combine presets with individual tools:
+
+```json
+{
+  "mcpServers": {
+    "lark-mcp": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@larksuiteoapi/lark-mcp",
+        "mcp",
+        "-a", "<your_app_id>",
+        "-s", "<your_app_secret>",
+        "-t", "preset.light,im.v1.message.create"
+      ]
+    }
+  }
+}
+```
+
+## Preset Tool Collections
+
+| Tool Name | Function Description | preset.light | preset.default (Default) | preset.im.default | preset.base.default | preset.base.batch | preset.doc.default | preset.task.default | preset.calendar.default |
+| --- | --- | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: |
+| im.v1.chat.create | Create a group chat | | ✓ | ✓ | | | | | |
+| im.v1.chat.list | Get group chat list | | ✓ | ✓ | | | | | |
+| im.v1.chat.search | Search group chats | ✓ | | | | | | | |
+| im.v1.chatMembers.get | Get group members | | ✓ | ✓ | | | | | |
+| im.v1.message.create | Send messages | ✓ | ✓ | ✓ | | | | | |
+| im.v1.message.list | Get message list | ✓ | ✓ | ✓ | | | | | |
+| bitable.v1.app.create | Create base | | ✓ | | ✓ | ✓ | | | |
+| bitable.v1.appTable.create | Create base data table | | ✓ | | ✓ | ✓ | | | |
+| bitable.v1.appTable.list | Get base data table list | | ✓ | | ✓ | ✓ | | | |
+| bitable.v1.appTableField.list | Get base data table field list | | ✓ | | ✓ | ✓ | | | |
+| bitable.v1.appTableRecord.search | Search base data table records | ✓ | ✓ | | ✓ | ✓ | | | |
+| bitable.v1.appTableRecord.create | Create base data table records | | ✓ | | ✓ | | | | |
+| bitable.v1.appTableRecord.batchCreate | Batch create base data table records | ✓ | | | | ✓ | | | |
+| bitable.v1.appTableRecord.update | Update base data table records | | ✓ | | ✓ | | | | |
+| bitable.v1.appTableRecord.batchUpdate | Batch update base data table records | | | | | ✓ | | | |
+| docx.v1.document.rawContent | Get document content | ✓ | ✓ | | | | ✓ | | |
+| docx.builtin.import | Import documents | ✓ | ✓ | | | | ✓ | | |
+| docx.builtin.search | Search documents | ✓ | ✓ | | | | ✓ | | |
+| drive.v1.permissionMember.create | Add collaborator permissions | | ✓ | | | | ✓ | | |
+| wiki.v2.space.getNode | Get Wiki node | ✓ | ✓ | | | | ✓ | | |
+| wiki.v1.node.search | Search Wiki nodes | | ✓ | | | | ✓ | | |
+| contact.v3.user.batchGetId | Batch get user IDs | ✓ | ✓ | | | | | | |
+| task.v2.task.create | Create task | | | | | | | ✓ | |
+| task.v2.task.patch | Modify task | | | | | | | ✓ | |
+| task.v2.task.addMembers | Add task members | | | | | | | ✓ | |
+| task.v2.task.addReminders | Add task reminders | | | | | | | ✓ | |
+| calendar.v4.calendarEvent.create | Create calendar event | | | | | | | | ✓ |
+| calendar.v4.calendarEvent.patch | Modify calendar event | | | | | | | | ✓ |
+| calendar.v4.calendarEvent.get | Get calendar event | | | | | | | | ✓ |
+| calendar.v4.freebusy.list | Query free/busy status | | | | | | | | ✓ |
+| calendar.v4.calendar.primary | Get primary calendar | | | | | | | | ✓ |
+
+> **Note**: In the table, "✓" indicates the tool is included in that preset. Using `-t preset.xxx` will enable tools marked with "✓" in the corresponding column.
+
+## Preset Descriptions
+
+### preset.light
+A minimal preset that includes only the most essential tools for basic messaging and document operations. Ideal for lightweight integrations.
+
+### preset.default (Default)
+The default preset that includes commonly used tools across messaging, documents, databases, and collaboration. Recommended for most users.
+
+### preset.im.default
+Focused on instant messaging functionality, including chat creation, member management, and message handling.
+
+### preset.base.default
+Includes basic database operations with BitTable (multi-dimensional tables) for data management scenarios.
+
+### preset.base.batch
+Specialized for batch operations on BitTable data, useful for bulk data processing.
+
+### preset.doc.default
+Document-focused preset including document reading, importing, searching, and collaboration features.
+
+### preset.task.default
+Task management focused preset for creating, modifying, and managing tasks with reminders and members.
+
+### preset.calendar.default
+Calendar management preset for creating, modifying events, and querying availability.
+
+## Related Documentation
+
+- [Main Documentation](../../../README.md)
+- [Tools Reference](./tools-en.md)
+- [Configuration Guide](../../usage/configuration/configuration.md)
+- [Command Line Reference](../cli/cli.md)