Lark MCP Server

🚀 Lark MCP Server

A Model Context Protocol (MCP) server implemented for Lark/Feishu, enabling MCP-compatible applications to interact with various collaborative features of Lark.

🚀 Quick Start

The Lark MCP server acts as a bridge between AI models and the Lark collaboration platform by implementing the Model Context Protocol (MCP) specification. This server allows AI assistants to:

• Send messages to Lark users.
• Retrieve calendar events.
• Create new calendar events.
• Add different types of participants to calendar events (users, groups, meeting rooms, external emails).

The server communicates with MCP clients using the standard input-output (stdio) transport layer, making it compatible with various AI model implementations that support the MCP standard.

✨ Features

• Message Sending: AI models can directly send messages to Lark users.
• Calendar Management:
  • List events within a specific time period.
  • Create new calendar events with customizable details.
  • Add various types of participants to events (users, groups, meeting rooms, external emails).

📦 Installation

Prerequisites

• Node.js v18 or higher.
• A registered Lark/Feishu application with appropriate permissions.
• A user access token for calendar operations.

Steps

1. Clone the repository:

   git clone https://github.com/junyuan-qi/lark-mcp-server.git
   cd lark-mcp-server
   

2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

💻 Usage Examples

Connecting with MCP Clients

The server communicates via standard input-output (stdio). MCP clients can connect to the server by starting it as a child process and communicating through its stdin/stdout channels.

Integrating with Claude Desktop

You can integrate this MCP server with Claude Desktop by configuring Claude Desktop to recognize and use the Lark MCP server.

1. Configure Claude Desktop to Recognize the Lark MCP Server

You can find the claude_desktop_config.json file in the settings of the Claude Desktop application:

1. Open the Claude Desktop application and enable developer mode from the top-left menu bar.
2. After enabling, open the settings (also from the top-left menu bar) and navigate to the developer options, where you'll see an "Edit Configuration" button. Click it to open the claude_desktop_config.json file for configuration.

2. Configuration Steps

Add the following content to the claude_desktop_config.json file:

{
    "mcpServers": [
        {
            "name": "Lark MCP Server",
            "host": "localhost",
            "port": 3000
        }
    ]
}

After saving the above code to the file, Claude Desktop will be able to connect to the Lark MCP server.

📚 Documentation

If you want to develop or contribute to the project, please refer to the project's GitHub repository for more information: Lark MCP Server