Provides a Node.js-based MCP server that encapsulates Feishu/Lark Open Platform API interfaces, allowing AI assistants to directly call these interfaces for various automation scenarios.
Feishu/Lark OpenAPI MCP
English | 中文
Developer Documentation Retrieval MCP
⚠️ Beta Version Notice: This tool is currently in Beta stage. Features and APIs may change, so please stay updated with version releases.
This is the Feishu/Lark official OpenAPI MCP (Model Context Protocol) tool designed to help users quickly connect to the Feishu/Lark platform and enable efficient collaboration between AI Agents and Feishu/Lark. The tool encapsulates Feishu/Lark Open Platform API interfaces as MCP tools, allowing AI assistants to directly call these interfaces and implement various automation scenarios such as document processing, conversation management, calendar scheduling, and more.
Preparation
Creating a Feishu/Lark Application
Before using the lark-mcp tool, you need to create a Feishu/Lark application:
- Visit the Feishu Open Platform or Lark Open Platform and log in
- Click "Console" and create a new application
- Obtain the App ID and App Secret, which will be used for API authentication
- Add the necessary permissions for your application based on your usage scenario
- If you need to call APIs as a user, set the OAuth 2.0 redirect URL to http://localhost:3000/callback
For detailed application creation and configuration guidelines, please refer to the Feishu Open Platform Documentation - Creating an Application.
Installing Node.js
Before using the lark-mcp tool, you need to install the Node.js environment.
Using the Official Installer (Recommended):
- Visit the Node.js website
- Download and install the LTS version
- After installation, verify in the terminal:
Quick Start
Using with Trae/Cursor/Claude
To integrate Feishu/Lark functionality in AI tools like Trae, Cursor or Claude, install using the button below.
or add the following to your configuration file:
If you need to access APIs with user identity, you need to login first using the login command in the terminal. Note that you need to configure the application's redirect URL in the developer console first, default is http://localhost:3000/callback
Then add the following to your configuration file:
Note: When enabling --oauth
, it's recommended to explicitly set --token-mode
to user_access_token
, which means calling APIs with user access tokens, suitable for accessing user resources or scenarios requiring user authorization (such as reading personal documents, sending IM messages). If you keep the default auto
, some APIs AI may fallback to tenant_access_token
, which could result in insufficient permissions or inability to access user private data.
Domain Configuration
Based on your usage scenario, lark-mcp supports configuring different domain environments:
Feishu (China Version):
- Default uses
https://open.feishu.cn
domain - Suitable for users in China
Lark (International Version):
- Uses
https://open.larksuite.com
domain - Suitable for overseas users or international version of Lark
To switch to the international version of Lark, add the --domain
parameter in your configuration:
💡 Tip: Ensure your application is created in the corresponding domain environment's open platform. International version applications cannot be used with Feishu China version, and vice versa.
Custom API Configuration
⚠️ File Upload/Download: File upload and download operations are not yet supported
⚠️ Document Editing: Direct editing of Feishu cloud documents is not supported (only importing and reading are available)
By default, the MCP service enables common APIs. To enable other tools or only specific APIs or presets, you can specify them using the -t
parameter in the MCP Client configuration (JSON):
For detailed information about all preset tool collections and which tools are included in each preset, please refer to the Preset Tool Collections Reference.
A complete list of all supported Feishu/Lark tools can be found in tools.md.
⚠️ Notice:Non-preset APIs have not undergone compatibility testing, and the AI may not perform optimally during the process of understanding and using them.
Development Integration
Developers can refer to the minimal example for integrating with Agent: lark-samples/mcp_quick_demo
.
You can also refer to the Lark bot integration example: lark-samples/mcp_larkbot_demo/nodejs
.
This example demonstrates how to integrate MCP capabilities into Feishu/Lark bots, triggering tool calls and message sending through bot conversations, suitable for scenarios that integrate existing tools into Bot.
Advanced Configuration
For detailed configuration options and deployment scenarios, please refer to our Configuration Guide.
For detailed information about all available command line parameters and their usage, please refer to the Command Line Reference.
FAQ
Related Links
- Feishu Open Platform
- Development Documentation: OpenAPI MCP
- Lark International Open Platform
- Feishu Open Platform API Documentation
- Node.js Website
- npm Documentation
Feedback
Issues are welcome to help improve this tool. If you have any questions or suggestions, please raise them in the GitHub repository.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A toolkit that enables AI assistants to directly call Feishu/Lark API interfaces for automation scenarios like document processing, conversation management, and calendar scheduling.
Related MCP Servers
- -securityAlicense-qualityProvides access to Feishu (Lark) documents for AI-driven coding tools like Cursor, Windsurf, and Cline based on Model Context Protocol implementation.Last updated -82136MIT License
- -securityFlicense-qualityA server that enables LLMs to interact with Lark/Feishu services, currently supporting employee information queries via Lark's Contact API.Last updated -63
- -securityAlicense-qualityAn MCP-based service that enables AI models to seamlessly interact with Feishu (Lark) platform, supporting document reading and chatbot messaging capabilities.Last updated -540MIT License
- -securityFlicense-qualityA Model Context Protocol server that enables AI models to perform function calls through Feishu/Lark messaging platform, using your personal account (no bot configuration needed) to create a full-featured AI assistant.Last updated -112