Feishu (Lark)

by cso1z

22 stars

1.4k downloads

Not rated

GitHub

About

Integrates with Feishu (Lark) to enable document retrieval, messaging, and collaborative features directly within workplace conversations through a TypeScript implementation that runs as either a CLI or HTTP server.

Details

Author: cso1z
Repository: cso1z/Feishu-MCP
GitHub stars: 22
Downloads: 1,414
License: MIT License
Categories: Productivity, Developer Tools, Design, Workplace, File Management, AI, Frontend, Search, Knowledge Base
Tags: #web, #integration

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Feishu (Lark)

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 -y
- Argument 2 feishu-mcp@latest
- Argument 3 --stdio
Environment
- FEISHU_APP_ID <你的飞书应用ID>
- FEISHU_USER_KEY <你的用户标识>
- FEISHU_AUTH_TYPE <tenant/user>
- FEISHU_APP_SECRET <你的飞书应用密钥>
- FEISHU_ENABLED_MODULES document,task
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "feishu (lark)": {
            "env": {
                "FEISHU_APP_ID": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528ID>",
                "FEISHU_USER_KEY": "<\u4f60\u7684\u7528\u6237\u6807\u8bc6>",
                "FEISHU_AUTH_TYPE": "<tenant/user>",
                "FEISHU_APP_SECRET": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528\u5bc6\u94a5>",
                "FEISHU_ENABLED_MODULES": "document,task"
            },
            "args": [
                "-y",
                "feishu-mcp@latest",
                "--stdio"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "feishu (lark)": {
            "env": {
                "FEISHU_APP_ID": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528ID>",
                "FEISHU_USER_KEY": "<\u4f60\u7684\u7528\u6237\u6807\u8bc6>",
                "FEISHU_AUTH_TYPE": "<tenant/user>",
                "FEISHU_APP_SECRET": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528\u5bc6\u94a5>",
                "FEISHU_ENABLED_MODULES": "document,task"
            },
            "args": [
                "/c",
                "npx",
                "-y",
                "feishu-mcp@latest",
                "--stdio"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "feishu (lark)": {
            "env": {
                "FEISHU_APP_ID": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528ID>",
                "FEISHU_USER_KEY": "<\u4f60\u7684\u7528\u6237\u6807\u8bc6>",
                "FEISHU_AUTH_TYPE": "<tenant/user>",
                "FEISHU_APP_SECRET": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528\u5bc6\u94a5>",
                "FEISHU_ENABLED_MODULES": "document,task"
            },
            "args": [
                "-y",
                "feishu-mcp@latest",
                "--stdio"
            ],
            "command": "npx"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "feishu (lark)": {
            "env": {
                "FEISHU_APP_ID": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528ID>",
                "FEISHU_USER_KEY": "<\u4f60\u7684\u7528\u6237\u6807\u8bc6>",
                "FEISHU_AUTH_TYPE": "<tenant/user>",
                "FEISHU_APP_SECRET": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528\u5bc6\u94a5>",
                "FEISHU_ENABLED_MODULES": "document,task"
            },
            "args": [
                "-y",
                "feishu-mcp@latest",
                "--stdio"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "feishu (lark)": {
            "env": {
                "FEISHU_APP_ID": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528ID>",
                "FEISHU_USER_KEY": "<\u4f60\u7684\u7528\u6237\u6807\u8bc6>",
                "FEISHU_AUTH_TYPE": "<tenant/user>",
                "FEISHU_APP_SECRET": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528\u5bc6\u94a5>",
                "FEISHU_ENABLED_MODULES": "document,task"
            },
            "args": [
                "/c",
                "npx",
                "-y",
                "feishu-mcp@latest",
                "--stdio"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "feishu (lark)": {
            "env": {
                "FEISHU_APP_ID": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528ID>",
                "FEISHU_USER_KEY": "<\u4f60\u7684\u7528\u6237\u6807\u8bc6>",
                "FEISHU_AUTH_TYPE": "<tenant/user>",
                "FEISHU_APP_SECRET": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528\u5bc6\u94a5>",
                "FEISHU_ENABLED_MODULES": "document,task"
            },
            "args": [
                "-y",
                "feishu-mcp@latest",
                "--stdio"
            ],
            "command": "npx"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "feishu (lark)": {
            "env": {
                "FEISHU_APP_ID": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528ID>",
                "FEISHU_USER_KEY": "<\u4f60\u7684\u7528\u6237\u6807\u8bc6>",
                "FEISHU_AUTH_TYPE": "<tenant/user>",
                "FEISHU_APP_SECRET": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528\u5bc6\u94a5>",
                "FEISHU_ENABLED_MODULES": "document,task"
            },
            "args": [
                "-y",
                "feishu-mcp@latest",
                "--stdio"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "feishu (lark)": {
            "env": {
                "FEISHU_APP_ID": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528ID>",
                "FEISHU_USER_KEY": "<\u4f60\u7684\u7528\u6237\u6807\u8bc6>",
                "FEISHU_AUTH_TYPE": "<tenant/user>",
                "FEISHU_APP_SECRET": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528\u5bc6\u94a5>",
                "FEISHU_ENABLED_MODULES": "document,task"
            },
            "args": [
                "/c",
                "npx",
                "-y",
                "feishu-mcp@latest",
                "--stdio"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "feishu (lark)": {
            "env": {
                "FEISHU_APP_ID": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528ID>",
                "FEISHU_USER_KEY": "<\u4f60\u7684\u7528\u6237\u6807\u8bc6>",
                "FEISHU_AUTH_TYPE": "<tenant/user>",
                "FEISHU_APP_SECRET": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528\u5bc6\u94a5>",
                "FEISHU_ENABLED_MODULES": "document,task"
            },
            "args": [
                "-y",
                "feishu-mcp@latest",
                "--stdio"
            ],
            "command": "npx"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "feishu (lark)": {
            "env": {
                "FEISHU_APP_ID": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528ID>",
                "FEISHU_USER_KEY": "<\u4f60\u7684\u7528\u6237\u6807\u8bc6>",
                "FEISHU_AUTH_TYPE": "<tenant/user>",
                "FEISHU_APP_SECRET": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528\u5bc6\u94a5>",
                "FEISHU_ENABLED_MODULES": "document,task"
            },
            "args": [
                "-y",
                "feishu-mcp@latest",
                "--stdio"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "feishu (lark)": {
            "env": {
                "FEISHU_APP_ID": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528ID>",
                "FEISHU_USER_KEY": "<\u4f60\u7684\u7528\u6237\u6807\u8bc6>",
                "FEISHU_AUTH_TYPE": "<tenant/user>",
                "FEISHU_APP_SECRET": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528\u5bc6\u94a5>",
                "FEISHU_ENABLED_MODULES": "document,task"
            },
            "args": [
                "/c",
                "npx",
                "-y",
                "feishu-mcp@latest",
                "--stdio"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "feishu (lark)": {
            "env": {
                "FEISHU_APP_ID": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528ID>",
                "FEISHU_USER_KEY": "<\u4f60\u7684\u7528\u6237\u6807\u8bc6>",
                "FEISHU_AUTH_TYPE": "<tenant/user>",
                "FEISHU_APP_SECRET": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528\u5bc6\u94a5>",
                "FEISHU_ENABLED_MODULES": "document,task"
            },
            "args": [
                "-y",
                "feishu-mcp@latest",
                "--stdio"
            ],
            "command": "npx"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "feishu (lark)": {
            "env": {
                "FEISHU_APP_ID": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528ID>",
                "FEISHU_USER_KEY": "<\u4f60\u7684\u7528\u6237\u6807\u8bc6>",
                "FEISHU_AUTH_TYPE": "<tenant/user>",
                "FEISHU_APP_SECRET": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528\u5bc6\u94a5>",
                "FEISHU_ENABLED_MODULES": "document,task"
            },
            "args": [
                "-y",
                "feishu-mcp@latest",
                "--stdio"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "feishu (lark)": {
            "env": {
                "FEISHU_APP_ID": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528ID>",
                "FEISHU_USER_KEY": "<\u4f60\u7684\u7528\u6237\u6807\u8bc6>",
                "FEISHU_AUTH_TYPE": "<tenant/user>",
                "FEISHU_APP_SECRET": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528\u5bc6\u94a5>",
                "FEISHU_ENABLED_MODULES": "document,task"
            },
            "args": [
                "/c",
                "npx",
                "-y",
                "feishu-mcp@latest",
                "--stdio"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "feishu (lark)": {
            "env": {
                "FEISHU_APP_ID": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528ID>",
                "FEISHU_USER_KEY": "<\u4f60\u7684\u7528\u6237\u6807\u8bc6>",
                "FEISHU_AUTH_TYPE": "<tenant/user>",
                "FEISHU_APP_SECRET": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528\u5bc6\u94a5>",
                "FEISHU_ENABLED_MODULES": "document,task"
            },
            "args": [
                "-y",
                "feishu-mcp@latest",
                "--stdio"
            ],
            "command": "npx"
        }
    }
}

`create_feishu_document`

创建新的飞书文档。使用场景：从零开始创建文档。

`get_feishu_document_info`

获取文档基本信息。使用场景：验证文档存在性和权限。

`get_feishu_document_blocks`

获取文档块结构。使用场景：了解文档层级结构。

`batch_create_feishu_blocks`

批量创建多个块。使用场景：高效创建连续内容。

`update_feishu_block_text`

更新块文本内容。使用场景：修改现有内容。

`delete_feishu_document_blocks`

删除文档块。使用场景：清理和重构文档内容。

`get_feishu_folder_files`

获取文件夹文件列表。使用场景：浏览文件夹内容。

`create_feishu_folder`

创建新文件夹。使用场景：组织文档结构。

`search_feishu_documents`

搜索文档。使用场景：查找特定内容。

`get_feishu_image_resource`

获取图片资源。使用场景：下载文档中的图片。

`get_feishu_whiteboard_content`

获取画板内容。使用场景：获取画板中的图形元素和结构（流程图、思维导图等）。

`create_feishu_table`

创建和编辑表格。使用场景：结构化数据展示。

`list_feishu_tasks`

列取我负责的任务。使用场景：查看待办/已完成任务。

`create_feishu_task`

批量创建任务（含子任务）。使用场景：新建任务、拆分子任务。

`update_feishu_task`

更新任务。使用场景：修改内容、成员、提醒。

`delete_feishu_task`

批量删除任务。使用场景：清理任务。

`get_feishu_users`

按名称搜索或按 ID 批量获取用户。使用场景：查找成员、任务分配。

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "feishu (lark)": {
            "env": {
                "FEISHU_APP_ID": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528ID>",
                "FEISHU_USER_KEY": "<\u4f60\u7684\u7528\u6237\u6807\u8bc6>",
                "FEISHU_AUTH_TYPE": "<tenant/user>",
                "FEISHU_APP_SECRET": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528\u5bc6\u94a5>",
                "FEISHU_ENABLED_MODULES": "document,task"
            },
            "args": [
                "-y",
                "feishu-mcp@latest",
                "--stdio"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": {
        "FEISHU_APP_ID": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528ID>",
        "FEISHU_USER_KEY": "<\u4f60\u7684\u7528\u6237\u6807\u8bc6>",
        "FEISHU_AUTH_TYPE": "<tenant/user>",
        "FEISHU_APP_SECRET": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528\u5bc6\u94a5>",
        "FEISHU_ENABLED_MODULES": "document,task"
    },
    "args": [
        "-y",
        "feishu-mcp@latest",
        "--stdio"
    ],
    "command": "npx"
}

Macos

{
    "env": {
        "FEISHU_APP_ID": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528ID>",
        "FEISHU_USER_KEY": "<\u4f60\u7684\u7528\u6237\u6807\u8bc6>",
        "FEISHU_AUTH_TYPE": "<tenant/user>",
        "FEISHU_APP_SECRET": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528\u5bc6\u94a5>",
        "FEISHU_ENABLED_MODULES": "document,task"
    },
    "args": [
        "-y",
        "feishu-mcp@latest",
        "--stdio"
    ],
    "command": "npx"
}

Windows

{
    "env": {
        "FEISHU_APP_ID": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528ID>",
        "FEISHU_USER_KEY": "<\u4f60\u7684\u7528\u6237\u6807\u8bc6>",
        "FEISHU_AUTH_TYPE": "<tenant/user>",
        "FEISHU_APP_SECRET": "<\u4f60\u7684\u98de\u4e66\u5e94\u7528\u5bc6\u94a5>",
        "FEISHU_ENABLED_MODULES": "document,task"
    },
    "args": [
        "/c",
        "npx",
        "-y",
        "feishu-mcp@latest",
        "--stdio"
    ],
    "command": "cmd"
}

飞书 MCP 服务器

为 Cursor、Windsurf、Cline 和其他 AI 驱动的编码工具提供访问、编辑和结构化处理飞书文档的能力，并支持飞书任务管理和用户信息查询，基于 Model Context Protocol 服务器实现。

现已支持 feishu-tool 独立 CLI 工具，可在终端或脚本中直接调用所有飞书工具，无需启动 MCP 服务器。配合 Feishu-Skill 可让 Claude Code 等 AI Agent 自动选择最合适的方式操作飞书。

本项目让 AI 编码工具能够：
- 文档处理：直接获取、理解、创建和编辑飞书文档，显著提升文档处理的智能化和效率
- 任务管理：列取、创建、更新、删除飞书任务，支持子任务和成员管理（需 user 认证）
- 用户信息：按名称搜索或按 ID 批量获取飞书用户，便于任务分配和文档协作（需 user 认证）

完整覆盖飞书文档的真实使用流程，助你高效利用文档资源：
1. 文件夹目录获取：快速获取和浏览飞书文档文件夹下的所有文档，便于整体管理和查找。
2. 内容获取与理解：支持结构化、分块、富文本等多维度内容读取，AI 能精准理解文档上下文。
3. 智能创建与编辑：可自动创建新文档、批量生成和编辑内容，满足多样化写作需求。
4. 高效检索与搜索：内置关键字搜索，帮助你在大量文档中迅速找到目标信息。
5. 任务管理与用户查询：支持飞书任务 CRUD 及用户信息搜索，便于在文档中关联任务和人员。

本项目让你在飞书文档的日常使用流程中实现智能获取、编辑和搜索，并扩展任务与用户管理能力，提升内容处理效率和体验。

💡项目推荐：

使用 Claude Code 推荐配合 claude-ip-guard —— 自动检测 IP 地理位置并拦截受限地区访问，防止因网络切换导致 Claude 封号。

🎬 使用演示视频

你可以通过以下视频了解 MCP 的实际使用效果和操作流程：

> ⭐ Star 本项目，第一时间获取最新功能和重要更新！ 关注项目可以让你不错过任何新特性、修复和优化，助你持续高效使用。你的支持也将帮助我们更好地完善和发展项目。⭐

---

🛠️ 工具功能详情

| 功能类别 | 工具名称 | 描述 | 使用场景 | 状态 |
|---------|--------------------------------------|-------------|--------------------------|-------|
| 文档管理 | create_feishu_document | 创建新的飞书文档 | 从零开始创建文档 | ✅ 已完成 |
| | get_feishu_document_info | 获取文档基本信息 | 验证文档存在性和权限 | ✅ 已完成 |
| | get_feishu_document_blocks | 获取文档块结构 | 了解文档层级结构 | ✅ 已完成 |
| 内容编辑 | batch_create_feishu_blocks | 批量创建多个块 | 高效创建连续内容 | ✅ 已完成 |
| | update_feishu_block_text | 更新块文本内容 | 修改现有内容 | ✅ 已完成 |
| | delete_feishu_document_blocks | 删除文档块 | 清理和重构文档内容 | ✅ 已完成 |
| 文件夹管理 | get_feishu_folder_files | 获取文件夹文件列表 | 浏览文件夹内容 | ✅ 已完成 |
| | create_feishu_folder | 创建新文件夹 | 组织文档结构 | ✅ 已完成 |
| 搜索功能 | search_feishu_documents | 搜索文档 | 查找特定内容 | ✅ 已完成 |
| 工具功能 | get_feishu_document_info | 获取wiki文档信息 | 将Wiki链接转为文档ID、创建wiki子节点 | ✅ 已完成 |
| | get_feishu_image_resource | 获取图片资源 | 下载文档中的图片 | ✅ 已完成 |
| | get_feishu_whiteboard_content | 获取画板内容 | 获取画板中的图形元素和结构(流程图、思维导图等) | ✅ 已完成 |
| 高级功能 | create_feishu_table | 创建和编辑表格 | 结构化数据展示 | ✅ 已完成 |
| | 流程图插入 | 支持流程图和思维导图 | 流程梳理和可视化 | ✅ 已完成 |
| | 流程图插入(画板形式) | 支持流程图和思维导图 | 流程梳理和可视化 | ✅ 已完成 |
| 图片插入 | upload_and_bind_image_to_block | 支持插入本地和远程图片 | 修改文档内容 | ✅ 已完成 |
| | 公式支持 | 支持数学公式 | 学术和技术文档 | ✅ 已完成 |
| | | | | |
| 任务管理 | list_feishu_tasks | 列取我负责的任务 | 查看待办/已完成任务 | ✅ 已完成 |
| | create_feishu_task | 批量创建任务（含子任务） | 新建任务、拆分子任务 | ✅ 已完成 |
| | update_feishu_task | 更新任务 | 修改内容、成员、提醒 | ✅ 已完成 |
| | delete_feishu_task | 批量删除任务 | 清理任务 | ✅ 已完成 |
| 用户信息 | get_feishu_users | 按名称搜索或按 ID 批量获取用户 | 查找成员、任务分配 | ✅ 已完成 |

🎨 支持的样式功能（基本支持md所有格式）

- 文本样式：粗体、斜体、下划线、删除线、行内代码
- 文本颜色：灰色、棕色、橙色、黄色、绿色、蓝色、紫色
- 对齐方式：左对齐、居中、右对齐
- 标题级别：支持1-9级标题
- 代码块：支持多种编程语言语法高亮
- 列表：有序列表（编号）、无序列表（项目符号）
- 图片：支持本地图片和网络图片
- 公式：在文本块中插入数学公式，支持LaTeX语法
- mermaid图表：支持流程图、时序图、思维导图、类图、饼图等等
- 表格：支持创建多行列表格，单元格可包含文本、标题、列表、代码块等多种内容类型
- 飞书文档画板：支持飞书文档的画板创建，提供更加更为丰富和多样化的内容。

---

📈 一周计划：提升工具效率

- ~~精简工具集：21个工具 → 13个工具，移除冗余，聚焦核心功能~~ 0.0.15 ✅
- ~~优化描述：7000+ tokens → 3000+ tokens，简化提示，节省请求token~~ 0.0.15 ✅
- ~~批量增强：新增批量更新、批量图片上传，单次操作效率提升50%~~ 0.0.15 ✅
- 流程优化：减少多步调用，实现一键完成复杂任务
- ~~支持多种凭证类型：包括 tenant_access_token和 user_access_token，满足不同场景下的认证需求~~ (飞书应用配置发生变更) 0.0.16 ✅。
- ~~支持cursor用户登录：方便在cursor平台用户认证不做了,没必要 ❌~~
- ~~支持mermaid图表：流程图、时序图等等，丰富文档内容~~ 0.1.11 ✅
- ~~支持表格创建：创建包含各种块类型的复杂表格，支持样式控制~~ 0.1.2 ✅
- ~~支持飞书多用户user认证：一人部署，可以多人使用~~ 0.1.3 ✅
- ~~支持user_access_token自动刷新：无需频繁授权，提高使用体验~~ 0.1.6 ✅
- ~~支持授权范围校验：对应用授权进行验证，以确保其符合当前工具的要求。如未满足条件，将提供友好的指引，以便用户更顺畅地使用~~ 0.1.7 ✅
- ~~支持创建画板内容：与Mermaid图表相比，画板能够展示更为丰富和多样化的内容，提供更为友好和愉悦的视觉体验~~ (飞书应用配置发生变更) 0.1.7 ✅
- 提取环境变量中的 feishuAppId 和 feishuAppSecret：将飞书配置从环境变量中分离出来，以便在诸如 cursor 等客户端中进行设置，从而支持一个服务共享给多个团队使用。
- ~~支持知识库和我的文档库：实现知识库、我的文档库节点遍历、节点创建、文件创建、搜索等功能~~ (飞书应用配置发生变更) 0.1.8 ✅
- 版本更新通知：在发布新版本时，及时向用户提供相关提示与说明。
- ~~stdio模式user认证问题：修复stdio模式下飞书user认证失败问题~~ 0.1.9 ✅
- ~~权限检查功能可配置化：将权限检查功能作为可配置选项，支持通过环境变量 FEISHU_SCOPE_VALIDATION 或命令行参数 --feishu-scope-validation 控制，默认启用，满足不同用户的使用场景~~ 0.2.0 ✅
- ~~优化缓存目录:把token等缓存保存到系统级的配置目录~~ 0.2.2 ✅ 感谢 Molunerfinn、leeeezx、Master-cai 三位朋友的建议及代码贡献
- ~~优化mcpTool相关代码：重新构建代码结构，以便为未来添加更多功能奠定基础~~ 0.2.3 ✅
- ~~支持任务管理：列取、创建、更新、删除飞书任务，支持子任务和成员管理~~ 0.2.4 ✅
- ~~支持用户信息查询：按名称搜索或按 ID 批量获取用户，便于任务分配和文档协作~~ 0.2.4 ✅
- ~~Tool API 层抽取：新建 Tool API 层，与 tool 层一一对应，统一参数校验、数据转换、错误映射等~~ ✅
- ~~兼容 CLI 模式：支持 feishu-tool <tool-name> '<json>' 命令行调用，便于脚本与自动化场景~~ 0.2.6 ✅
- ~~完成 Skill：提供 Feishu-Skill，指导 Claude Code 等 AI Agent 在合适场景下使用 feishu-mcp CLI~~ 0.2.6 ✅
---

🔧 飞书配置教程

⚠️ 重要提示：在开始使用之前，必须先完成飞书应用配置，否则无法正常使用本工具。

关于如何创建飞书应用和获取应用凭证的说明可以在官方教程找到。

详细的飞书应用配置步骤：有关注册飞书应用、配置权限、添加文档访问权限的详细指南，请参阅手把手教程 FEISHU_CONFIG.md。

---

🏃‍♂️ 快速开始

方式一：使用 NPM 快速运行

npx feishu-mcp@latest --feishu-app-id=<你的飞书应用ID> --feishu-app-secret=<你的飞书应用密钥> --feishu-auth-type=<tenant/user> --enabled-modules=<document,task>

方式二：本地运行
1. 克隆仓库
git clone https://github.com/cso1z/Feishu-MCP.git cd Feishu-MCP

2. 配置环境变量(复制一份.env.example保存为.env文件)

3. 编辑 .env 文件
在项目根目录下找到并用任意文本编辑器打开 .env 文件，填写你的飞书应用凭证：

   FEISHU_APP_ID=cli_xxxxx

   FEISHU_APP_SECRET=xxxxx

   PORT=3333

   FEISHU_AUTH_TYPE=tenant/user

   FEISHU_ENABLED_MODULES=document,task

4. 运行服务器

方式一：本地运行
- 安装依赖

     pnpm install

- 启动服务

pnpm run dev

方式二：使用 Docker Compose
- 启动服务

     docker-compose up -d

- 查看日志

docker-compose logs -f

---

🖥️ feishu-tool CLI 工具

从 0.2.5 版本起，feishu-mcp npm 包随附 feishu-tool 独立 CLI，可在终端、Shell 脚本或 AI Agent 中直接调用所有飞书工具，无需启动 MCP 服务器**。

安装

# 全局安装（推荐）
npm install -g feishu-mcp@latest

配置

```bash

1. 查看 CLI 概览（子命令 + 可用工具集）

feishu-tool --help

2. 查看初始化指南（获取 App ID / Secret 的步骤说明）

feishu-tool guide

3. 写入凭证

feishu-tool config set FEISHU_APP_ID cli_xxxxx feishu-tool config set FEISHU_USER_KEY "$(node -e 'console.log(crypto.randomUUID())')"

FEISHU_USER_KEY 建议每个本地用户或客户端保持唯一

4. 查看当前配置（确认写入正确）

feishu-tool config

5. 查看某个工具的详细参数

feishu-tool help create_feishu_document

…

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

create_feishu_document

get_feishu_document_info

get_feishu_document_blocks

batch_create_feishu_blocks

update_feishu_block_text

delete_feishu_document_blocks

get_feishu_folder_files

create_feishu_folder

search_feishu_documents

get_feishu_image_resource

get_feishu_whiteboard_content

create_feishu_table

list_feishu_tasks

create_feishu_task

update_feishu_task

delete_feishu_task

get_feishu_users

Claude Desktop / Cursor

Linux

Macos

Windows

飞书 MCP 服务器

💡项目推荐：

🎬 使用演示视频

🛠️ 工具功能详情

🎨 支持的样式功能（基本支持md所有格式）

📈 一周计划：提升工具效率

🔧 飞书配置教程

🏃‍♂️ 快速开始

方式一：使用 NPM 快速运行

方式二：本地运行

🖥️ feishu-tool CLI 工具

安装

配置

1. 查看 CLI 概览（子命令 + 可用工具集）

2. 查看初始化指南（获取 App ID / Secret 的步骤说明）

3. 写入凭证

FEISHU_USER_KEY 建议每个本地用户或客户端保持唯一

4. 查看当前配置（确认写入正确）

5. 查看某个工具的详细参数

Install

More like this

Time

Sentry

Github

Git

GitLab

Context 7

`create_feishu_document`

`get_feishu_document_info`

`get_feishu_document_blocks`

`batch_create_feishu_blocks`

`update_feishu_block_text`

`delete_feishu_document_blocks`

`get_feishu_folder_files`

`create_feishu_folder`

`search_feishu_documents`

`get_feishu_image_resource`

`get_feishu_whiteboard_content`

`create_feishu_table`

`list_feishu_tasks`

`create_feishu_task`

`update_feishu_task`

`delete_feishu_task`

`get_feishu_users`