Lark MCP Server

A Model Context Protocol (MCP) server that integrates with Lark/Feishu APIs, allowing LLMs to interact with Lark services.

Features

• Query employee information using Lark's Contact API

• More features coming soon...

Related MCP server: Feishu MCP Server

Prerequisites

• Node.js 16 or higher

• A Lark/Feishu application with App ID and App Secret

• Claude for Desktop or another MCP client

Installation

npm install
npm run build

Usage

You can run the server in two ways:

1. Using Command Line Arguments (Recommended)

npx lark-mcp <app_id> <app_secret>

Replace <app_id> and <app_secret> with your Lark application credentials.

2. Using Environment Variables

export LARK_APP_ID=your_app_id
export LARK_APP_SECRET=your_app_secret
npx lark-mcp

Available Tools

get-user-info

Retrieves employee information using their ID.

Example usage in Claude:

Please look up employee information for ID 12345

Development

1. Clone the repository

2. Install dependencies:

   npm install

3. Build the project:

   npm run build

4. Start the server in development mode:

   npm run dev

Configuration

The server prioritizes credentials in the following order:

1. Command line arguments

2. Environment variables

3. Default values (if any)

Error Handling

• The server will validate credentials before starting

• API errors are properly handled and returned to the client

• Detailed error messages help with troubleshooting

License

MIT

Contributing

1. Fork the repository

2. Create your feature branch

3. Commit your changes

4. Push to the branch

5. Create a new Pull Request