Lark(Feishu)

What is mcp_server_lark?

mcp_server_lark is a Model Context Protocol (MCP) server designed to interact with Lark (Feishu), a popular collaboration and office suite. It enables automation of tasks within Lark, specifically focusing on sheet, message, and document operations. The server acts as an intermediary, allowing external applications or systems to leverage Lark's functionalities through the MCP.

How to use mcp_server_lark?

To use mcp_server_lark, you need to:

1. Create a Lark (Feishu) app: Visit the Lark Open Platform to set up a new application.
2. Apply Permissions: Grant necessary permissions to your Lark app, such as sheets:spreadsheet:readonly for sheet operations.
3. Configure Environment Variables: Set LARK_APP_ID and LARK_APP_SECRET with your application credentials.
4. Integrate with your host: Add the server to your host configuration, specifying its description, command, arguments, and environment variables as shown in the example usage.

Key Features of mcp_server_lark

• write_excel: This core tool allows you to write data to a specified sheet within a Lark (Feishu) spreadsheet and generates a link to the updated sheet. It supports adding access by providing an email.
• Model Context Protocol (MCP) Integration: Provides a standardized way to interact with Lark services.
• Automation Capabilities: Facilitates automated operations on Lark sheets, messages, and documents.

Use Cases of mcp_server_lark

• Automated Report Generation: Automatically populate Lark sheets with data from other systems for reporting purposes.
• Workflow Automation: Integrate Lark into existing workflows to automate tasks like sending messages or updating documents based on triggers.
• Data Synchronization: Keep data in Lark sheets synchronized with external databases or applications.
• Custom Lark Applications: Develop custom applications that leverage Lark's functionalities through the MCP server.

FAQ from mcp_server_lark

• What permissions are required? At a minimum, sheets:spreadsheet:readonly is mentioned for sheet operations. Depending on your use case, additional permissions for messages or documents might be necessary.
• How do I get LARK_APP_ID and LARK_APP_SECRET? These credentials are obtained when you create an application on the Lark Open Platform.
• Can I write to other Lark document types besides sheets? The description mentions "sheet, message, doc and etc.", but the current core tool specifically highlights write_excel for sheets. Further tools might be developed for other document types.
• Is there a license for this project? Yes, the project is released under the MIT License.

MCP Server For Lark (Feishu)

A Model Context Protocol server for Lark(Feishu) sheet, message, doc and etc.

Tools

The server offers one core tools now:

• write_excel
  • Write data to a sheet in a Lark(Feishu) sheet and return a link.
  • Need to provide a email to add access.

Configuration

1. Create a Lark(Feishu) app

Visit the Lark Open Platform: https://open.larkoffice.com/app

2. Apply Permissions for the App

sheets:spreadsheet:readonly

3. Environment Variables

LARK_APP_ID=your_app_id
LARK_APP_SECRET=your_app_secret

Usage

# Add the server to your host
"mcpServers": {
  "mcpServerLark": {
    "description": "MCP Server For Lark(Feishu)",
    "command": "uvx",
    "args": [
      "parent_of_servers_repo/servers/src/mcp_server_lark"
    ],
    "env": {
        "LARK_APP_ID": "xxx",
        "LARK_APP_SECRET": "xxx"
    }
  }
}

License

MIT License