home / mcp / lark mcp server

Lark MCP Server

Bridges MCP-enabled AI models with Lark to send messages and manage calendar events.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "junyuan-qi-lark-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/lark-mcp-server/build/index.js"
      ],
      "env": {
        "LARK_APP_ID": "YOUR_APP_ID",
        "LARK_USER_ID": "TARGET_USER_ID",
        "LARK_APP_SECRET": "YOUR_APP_SECRET",
        "LARK_CALENDAR_ID": "TARGET_CALENDAR_ID",
        "LARK_USER_ACCESS_TOKEN": "YOUR_USER_ACCESS_TOKEN"
      }
    }
  }
}

You run a Model Context Protocol (MCP) server that lets AI models interact with Lark/Feishu—sending messages, reading and creating calendar events, and managing attendees. This server communicates over standard input/output (stdio), so your MCP client launches it as a child process and talks through its stdin and stdout. This approach makes it easy to integrate with a wide range of MCP-enabled assistants while keeping the interaction lightweight and flexible.

How to use

You connect an MCP client to the Lark MCP Server using standard input/output (stdio). Launch the server as a child process and pair its stdin/stdout with your MCP client. Once connected, your assistant can send direct messages to Lark users, list calendar events within a time window, create new events, and add attendees of various types (users, groups, meeting rooms, or external emails). Start the server, then initiate requests from your MCP client as you would with any MCP-compliant backend.

Typical usage patterns include: sign in with your Lark credentials, request a list of upcoming events, create a new event with a specified time and attendees, or send a message to a specific Lark user. Ensure your MCP client passes the correct environment variables and has the required permissions for calendar operations and messaging.

How to install

Prerequisites you must have before installation:

Node.js v18 or higher

A registered Lark/Feishu application with appropriate permissions

A user access token with calendar permissions

Step by step setup commands:

# Clone the MCP server repository
git clone https://github.com/junyuan-qi/lark-mcp-server.git
cd lark-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

# Start the server (stdio mode) via your MCP client or directly for testing
node build/index.js

MCP server configuration

{
  "mcpServers": {
    "lark_mcp": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/lark-mcp-server/build/index.js"],
      "env": {
        "LARK_APP_ID": "YOUR_APP_ID",
        "LARK_APP_SECRET": "YOUR_APP_SECRET",
        "LARK_USER_ID": "TARGET_USER_ID",
        "LARK_CALENDAR_ID": "TARGET_CALENDAR_ID",
        "LARK_USER_ACCESS_TOKEN": "YOUR_USER_ACCESS_TOKEN"
      }
    }
  }
}

Available tools

send_message

Send a direct message from your MCP client to a specific Lark user.

list_events

List calendar events within a given time range.

create_event

Create a new calendar event with details such as time, location, and attendees.

add_attendees

Add attendees to an existing calendar event, including users, groups, rooms, or external emails.