Lark

GitHub
Integrates with
Lark, Feishu

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...

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