feishu

This MCP server provides Feishu (Feishu) integration capabilities as part of the Model Context Protocol (MCP). It exposes tools to interact with Feishu documents, bots, chats and Feishu multisheet (Feishu tables) APIs via a standardized MCP tool interface. You can run the server in STDIO or HTTP modes and invoke a set of tools such as get_feishu_doc_raw, get_feishu_doc_info, send_feishu_text_message, send_feishu_card, get_feishu_chat_info, get_feishu_sheet_meta, get_feishu_sheet_tables, get_feishu_sheet_views, get_feishu_sheet_view, get_feishu_sheet_records, and get_feishu_sheet_record. The server enforces structured input validation and returns results in a consistent JSON format. To use it, start the server and call the registered MCP tools through the configured channel (STDIO or HTTP) using the provided tool names and parameters. Authentication with Feishu is handled via the configured Feishu App ID and App Secret, and environment variables control server behavior such as port and log level.

Prerequisites:

• Node.js 23.x or higher
• pnpm (preferred) or npm
• Feishu developer account and self-built Feishu app credentials (App ID and App Secret)

1. Clone the repository:

git clone https://github.com/yourusername/feishu-mcp-server.git
cd feishu-mcp-server

2. Install dependencies:

pnpm install
# or
npm install

3. Configure environment variables. Create a .env file or export variables:

# Feishu app credentials
export FEISHU_APP_ID=your_app_id
export FEISHU_APP_SECRET=your_app_secret

# Server configuration (optional)
export PORT=3344
export LOG_LEVEL=info

4. Build and run the server (development or production):

# Development mode (hot-reload if configured)
pnpm run dev

# Or build and run production
pnpm build
node dist/index.js

5. Alternative (STDIO mode):

NODE_ENV=cli node dist/index.js --stdio

Tips:

• Ensure Feishu App credentials have the necessary permissions for the API scopes used by the server.
• If you encounter token expiration, verify TOKEN_CACHE_DURATION (in seconds) and token refresh behavior in the service layer.
• In STDIO mode, communicate using standard I/O streams; in HTTP mode, the server exposes REST endpoints and SSE for real-time updates.
• Common issues: misconfigured environment variables, network firewall blocking Feishu API calls, or insufficient permissions for the Feishu app.
• The server uses TypeScript with strict type checks; follow the provided error handling guidance (FeiShuApiError) for robust troubleshooting.