feishu-mcp
Enables AI coding agents like Cursor and Claude Code to interact with Feishu (Lark) via the Model Context Protocol. It supports managing documents, sending messages, and searching knowledge bases directly through natural language commands.
README
📄 feishu-mcp
让 AI Coding Agent（Cursor / Claude Code / Windsurf / OpenClaw）通过 MCP 协议直接操作飞书。
🎯 解决什么问题
你用 Cursor/Claude 写代码时，需要：
- 读飞书文档里的需求 → 以前：切换浏览器复制粘贴
- 把代码文档写到飞书 → 以前：手动创建文档再粘贴
- 给同事发个飞书消息通知 → 以前：切换到飞书App
现在：直接在 AI 对话框里说一句话就行。
🛠️ 8 个工具
| 工具 | 功能 | 示例指令 |
|---|---|---|
feishu_doc_read |
读取文档内容 | "帮我读一下飞书文档 doc_xxx" |
feishu_doc_write |
写入/更新文档 | "把这段markdown写到飞书文档里" |
feishu_doc_create |
创建新文档 | "在飞书创建一个API设计文档" |
feishu_doc_list |
列出文件夹文件 | "看看我的飞书xxx文件夹里有什么" |
feishu_message_send |
发送消息 | "给张三发条飞书说代码已上线" |
feishu_wiki_search |
搜索知识库 | "在飞书知识库搜一下部署流程" |
feishu_calendar_create |
创建日历事件 | "帮我建个明天10点的需求评审会议" |
feishu_bitable |
操作多维表格 | "在项目跟踪表里加一条新需求" |
🚀 安装（3步）
1. 克隆并安装依赖
git clone https://github.com/zlplzp123wyt/feishu-mcp.git
cd feishu-mcp
npm install
npm run build
2. 获取飞书应用凭证
- 登录 飞书开放平台
- 创建企业自建应用
- 获取
App ID和App Secret - 开通所需权限（文档读写、消息发送等）
3. 配置 MCP Client
Cursor
在 ~/.cursor/mcp.json 中添加：
{
"mcpServers": {
"feishu": {
"command": "node",
"args": ["/path/to/feishu-mcp/dist/index.js"],
"env": {
"FEISHU_APP_ID": "cli_xxxxxxxxxxxxxxxx",
"FEISHU_APP_SECRET": "xxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}
Claude Desktop
在 claude_desktop_config.json 中添加相同的配置。
OpenClaw
在 OpenClaw 配置中添加 MCP server。
📋 飞书应用所需权限
| 权限 | 用途 |
|---|---|
docx:document |
读写文档 |
drive:drive |
访问云空间 |
im:message:send_as_bot |
发送消息 |
wiki:wiki |
知识库搜索 |
🏗️ 技术栈
- TypeScript + Node.js
- MCP SDK (
@modelcontextprotocol/sdk) - Zod（参数校验）
- 飞书 Open API
💰 适用场景
- 开发者：Cursor/Claude写代码时直接操作飞书
- 团队协作：AI自动把代码文档同步到飞书
- 自动化：用AI Agent自动管理飞书内容
- 企业定制：基于此MCP server开发定制化飞书集成
📄 License
MIT
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.