Get the FREE Ultimate OpenClaw Setup Guide →

lark

MCP server from junyuan-qi/lark-mcp-server

Installation
Run this command in your terminal to add the MCP server to Claude Code.
Run in terminal:
Command
claude mcp add --transport stdio junyuan-qi-lark-mcp-server node build/index.js \
  --env LARK_APP_ID="your_app_id" \
  --env LARK_USER_ID="target_user_id" \
  --env LARK_APP_SECRET="your_app_secret" \
  --env LARK_CALENDAR_ID="target_calendar_id" \
  --env LARK_USER_ACCESS_TOKEN="your_user_access_token"

How to use

The Lark MCP Server provides a bridge between AI models and the Lark/Feishu collaboration platform using the Model Context Protocol (MCP) over standard input/output. It enables AI agents to perform common collaboration tasks by sending MCP requests through the server process and receiving responses via stdout. The server supports message delivery to Lark users and calendar management operations, including listing calendar events, creating new events, and attaching attendees to events. This makes it possible to integrate Lark-enabled capabilities into model workflows, chat assistants, or orchestration systems that implement MCP.

How to install

Prerequisites:

  • Node.js v18 or higher
  • NPM (comes with Node.js)
  • Access to a registered Lark/Feishu application with the necessary permissions

Installation 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

  4. Run the server (example) npm start // or execute the built file directly if you prefer node build/index.js

Environment setup (required for Lark operations):

  • Set up environment variables (see mcp_config for placeholders): 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"

Additional notes

Tips and common issues:

  • Ensure the Lark app has the correct permissions for messaging and calendar access.
  • Confirm that the provided tokens and IDs are valid and not expired.
  • If you encounter initialization errors, check that all required environment variables are set.
  • The MCP transport is stdio; integrate this server by spawning it as a child process and wiring requests/responses to its stdin/stdout.
  • When deploying with Claude Desktop or other MCP clients, provide the build/index.js path and environment variables in the client configuration (as shown in the example claude_desktop_config.json snippet).
  • For troubleshooting, inspect logs written to stderr for error messages related to authentication, permissions, or invalid request parameters.

Related MCP Servers

Sponsor this space

Reach thousands of developers