feishu-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LARK_PROFILE | No | Multi-app profile name; injects --profile when set. | |
| LARK_CLI_PATH | No | Path to the lark-cli executable. | lark-cli |
| LARK_IDENTITY | No | Invocation identity: 'user' or 'bot'. | user |
| MCP_HTTP_HOST | No | Host to bind; use 127.0.0.1 behind reverse proxy, 0.0.0.0 for direct access. | 127.0.0.1 |
| MCP_HTTP_PORT | No | Port to listen on; endpoint is /mcp. | 3000 |
| MCP_TRANSPORT | No | Set to 'http' to start HTTP(S) service; defaults to 'stdio'. | stdio |
| MCP_HTTP_TOKEN | No | Required in HTTP mode; Bearer token, comma-separated for multiple tokens; server refuses to start if not configured. | |
| LARK_TIMEOUT_MS | No | Timeout for a single lark-cli invocation in milliseconds. | 120000 |
| MCP_HTTP_TLS_KEY | No | Path to TLS private key; if both certificate and key are set, server starts with HTTPS. | |
| FEISHU_MCP_CONFIG | No | Path to a JSON configuration file; environment variables take precedence over the file. | ~/.feishu-mcp/config.json |
| MCP_HTTP_TLS_CERT | No | Path to TLS certificate; if both certificate and key are set, server starts with HTTPS. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| read_feishu_docA | 读取飞书云文档内容（支持文档链接 /docx/ 或知识库链接 /wiki/，自动路由），返回 Markdown。可读全文、目录大纲（scope=outline，先看结构）、指定章节（需 block id）、关键词定位。返回 JSON 含 document_id / revision_id / content。 |
| write_feishu_docA | 写入飞书云文档（docx / wiki），内容用 Markdown。模式：create=新建文档（需 title）；append=在文末追加；replace=整篇覆盖已有文档（慎用，会丢弃原有内容）；replace_text=把文档中的精确旧文本替换为新文本（适合小改动）。新建成功返回新文档的 url 和 document_id。 |
| read_feishu_sheetA | 读取飞书电子表格（电子表格 spreadsheet，不是多维表格）。不传 sheet_name/sheet_id 时返回工作簿的子表清单；传入子表后按区域读取，默认返回 CSV 文本（纯值），detail=cells 可读公式/样式/批注。 |
| write_feishu_sheetA | 写入飞书电子表格。模式：overwrite=从锚点单元格（默认 A1）开始粘贴 CSV 文本；append=把 CSV（首行为表头）追加到子表末行；set_cell=向指定区域写值或公式（cells 为二维数组，如 [[{"value":"名称"},{"formula":"=SUM(A1:A2)"}]]）。 |
| read_feishu_base_recordsA | 读取飞书多维表格（bitable）的数据表记录，返回对象数组（每条含 record_id 和字段值）。可按字段筛选（op 支持 ==/!=/>/>=/</<=/intersects/contains/is_empty/non_empty）、排序、字段投影、分页。先用 describe_feishu_base 获取 table_id 和字段名。base_token 支持多维表格 URL、wiki URL 或裸 token。 |
| write_feishu_base_recordsA | 向飞书多维表格（bitable）批量新增或更新记录，单次最多 200 条。mode=create 时 records 为字段对象数组；mode=update 时每项需含 record_id 和 fields。字段值约定：文本直接字符串，单选/多选用字符串数组，日期用 'YYYY-MM-DD HH:mm'，勾选用 true/false，数字用数值。先用 describe_feishu_base 确认可写字段。 |
| describe_feishu_baseA | 列出飞书多维表格（bitable）的所有数据表及每张表的字段 schema（字段名/类型/可选值），用于读写记录前发现 table_id、准确字段名和字段类型约定（如单选字段的合法选项）。base_token 支持多维表格 URL、wiki 知识库 URL 或裸 token。 |
| search_feishu_docsA | 按关键词搜索我有权限的飞书云空间对象（文档/电子表格/多维表格/知识库文档等），返回标题、类型、URL、更新时间。关键词最长 30 个字符。拿到 URL/token 后可用 read_feishu_doc 等工具进一步读写。 |
| check_feishu_authA | 检查 lark-cli 是否已安装、当前登录状态与可用身份（user/bot）。读写报权限错误时先调用本工具排查。未登录时按返回的指引让用户在部署机上执行登录命令。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 9 tools
Tools are mostly distinct by resource type (doc vs sheet vs base) and action (read vs write vs describe vs search vs auth). The only potential confusion is read_feishu_doc vs search_feishu_docs (both involve docs) and read_feishu_sheet vs read_feishu_base_records (both read tabular data), but descriptions clarify the resource types clearly.
Most tools follow a consistent verb_noun pattern: read_feishu_doc, write_feishu_doc, read_feishu_sheet, write_feishu_sheet, read_feishu_base_records, write_feishu_base_records. Minor deviations: describe_feishu_base (uses describe instead of read), search_feishu_docs (plural docs), and check_feishu_auth (uses check instead of a resource noun).
9 tools is well-scoped for a Feishu/Lark workspace server covering docs, sheets, bitable, search, and auth. Each tool earns its place and the count is within the ideal 3-15 range.
The server covers read/write for docs, sheets, and bitable records, plus schema discovery, search, and auth check. Minor gaps: no delete/update for docs or sheets, no bitable table creation or schema modification, and no explicit tool for listing docs/sheets (though search covers discovery).