Feishu Business Operations

Created By

haohanghao0321-cpua month ago

AI-native business operations MCP server for Feishu/Lark. 8 scenario-based tools for multidimensional tables (search, query, write, create, AI schema design) and approvals (list, alerts, stats).

# feishu

# lark

Overview Content Tools Comments

Overview

feishu-scenarios-mcp

AI-native business operations MCP server for Feishu/Lark. 8 scenario-based tools covering multidimensional tables (Bitable) and approvals — search, query, write, create, AI schema design, approval tracking, alerts, and statistics.

Installation

npm install -g feishu-scenarios-mcp

Or run directly:

npx feishu-scenarios-mcp

Configuration

Create a .env file with your Feishu app credentials:

FEISHU_APP_ID=cli_xxxxxxxxxxxx
FEISHU_APP_SECRET=xxxxxxxxxxxxxxxxxxxxxxxx
FEISHU_BITABLE_APP_TOKEN=xxxxxxxxxxxx
FEISHU_ENV=feishu

Variable	Required	Description
`FEISHU_APP_ID`	Yes	Feishu app ID from Developer Console
`FEISHU_APP_SECRET`	Yes	Feishu app secret
`FEISHU_BITABLE_APP_TOKEN`	For bitable	Bitable app token
`FEISHU_ENV`	No	`feishu` (default) or `lark`
`FEISHU_USER_ID`	For approval	Your Feishu user open_id
`DEEPSEEK_API_KEY`	For schema AI	DeepSeek API key for AI table design

Claude Desktop Setup

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "feishu-scenarios": {
      "command": "npx",
      "args": ["-y", "feishu-scenarios-mcp"],
      "env": {
        "FEISHU_APP_ID": "cli_xxxxxxxxxxxx",
        "FEISHU_APP_SECRET": "xxxxxxxxxxxxxxxx",
        "FEISHU_BITABLE_APP_TOKEN": "xxxxxxxxxxxx",
        "FEISHU_ENV": "feishu"
      }
    }
  }
}

Tools

Bitable (多维表格)

Tool	Description
`bitable_search`	Search tables by keyword. Returns table ID, name, field preview, record count.
`bitable_query`	Query records with optional filters.
`bitable_upsert`	Batch write records. Auto field-name matching and type conversion.
`bitable_create`	Create a new table with field definitions.
`bitable_schema_ai`	AI-designed table schema from business description. Requires `DEEPSEEK_API_KEY`.

Approval (审批)

Tool	Description
`approval_list`	Query approval instances by status, type, applicant, time range.
`approval_alerts`	Find bottlenecks and overtime approvals. Default threshold 48h.
`approval_stats`	Approval statistics: by status, type, month, top applicants.

Usage Examples

Search tables:

"搜一下包含'审批'的表格"

Query records:

"查一下积压跟踪表里 pending 状态的记录"

Write records:

"往跟踪表写一条记录，负责人张三，状态待处理"

AI design table:

"帮我设计一张跟踪审批积压的表"

Approval alerts:

"谁审批最慢"

Approval statistics:

"本月审批通过率"

Feishu Bot (Mobile)

The package also includes a WebSocket-based Feishu bot for mobile access:

npx feishu-scenarios-mcp-bot

Setup guide: docs/bot-setup.md

Required Feishu Permissions

approval:instance — read approval instances
bitable:app — access bitable
im:message — bot messaging
im:message:send_as_bot — send bot messages

License

MIT

Server Config

{
  "mcpServers": {
    "feishu-scenarios": {
      "command": "npx",
      "args": [
        "-y",
        "feishu-scenarios-mcp"
      ],
      "env": {
        "FEISHU_APP_ID": "<你的飞书App ID>",
        "FEISHU_APP_SECRET": "<你的飞书App Secret>",
        "FEISHU_BITABLE_APP_TOKEN": "<你的多维表格App Token>",
        "FEISHU_ENV": "feishu",
        "FEISHU_USER_ID": "<你的飞书Open ID (可选)>",
        "DEEPSEEK_API_KEY": "<你的DeepSeek Key (可选)>"
      }
    }
  }
}

Recommend Servers

TraeBuild with Free GPT-4.1 & Claude 3.7. Fully MCP-Ready.

MCP AdvisorMCP Advisor & Installation - Use the right MCP server for your needs

Jina AI MCP ToolsA Model Context Protocol (MCP) server that integrates with Jina AI Search Foundation APIs.

EdgeOne Pages MCPAn MCP service designed for deploying HTML content to EdgeOne Pages and obtaining an accessible public URL.

DeepChatYour AI Partner on Desktop

Y GuiA web-based graphical interface for AI chat interactions with support for multiple AI models and MCP (Model Context Protocol) servers.

ChatWiseThe second fastest AI chatbot™

WindsurfThe new purpose-built IDE to harness magic

AiimagemultistyleA Model Context Protocol (MCP) server for image generation and manipulation using fal.ai's Stable Diffusion model.

MiniMax MCPOfficial MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.

Zhipu Web SearchZhipu Web Search MCP Server is a search engine specifically designed for large models. It integrates four search engines, allowing users to flexibly compare and switch between them. Building upon the web crawling and ranking capabilities of traditional search engines, it enhances intent recognition capabilities, returning results more suitable for large model processing (such as webpage titles, URLs, summaries, site names, site icons, etc.). This helps AI applications achieve "dynamic knowledge acquisition" and "precise scenario adaptation" capabilities.