Lark Tools MCP

v1.0.0Communicationstable

lark-tools-mcp connects Lark and cursor. It provides cursor with the ability to read documents, send messages, process tasks, and perform data analysis.

lark-toolsmcpai-integration
Share:
34
Stars
0
Downloads
0
Weekly
0/5

What is Lark Tools MCP?

Lark Tools MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to lark-tools-mcp connects lark and cursor. it provides cursor with the ability to read documents, send messages, process tasks, and perform data analysis.

lark-tools-mcp connects Lark and cursor. It provides cursor with the ability to read documents, send messages, process tasks, and perform data analysis.

This server falls under the Communication and Business Applications categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • lark-tools-mcp connects Lark and cursor. It provides cursor

Use Cases

Read and share Lark documents with AI.
Send messages and process tasks in Lark.
Perform data analysis within Lark workspace.
VienLi

Maintainer

LicenseMIT License
Languagejavascript
Versionv1.0.0
UpdatedMar 28, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx lark-tools

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Lark Tools MCP

lark-tools-mcp bridges Feishu/Lark — the Chinese workplace collaboration platform — with AI coding assistants like Cursor and Claude. It authenticates as a Feishu custom app using your app credentials and currently exposes a tool to retrieve full document content as plain text, with the roadmap including messaging, task management, and data analysis operations. Teams that store specifications, contracts, or reference material in Feishu can use this server to let AI agents read those documents directly without manual copy-paste.

Prerequisites

  • Node.js 18 or later and yarn (npm install -g yarn)
  • A Feishu (Lark) account and a self-built custom app with document read permissions
  • FEISHU_APP_ID and FEISHU_APP_SECRET from your Feishu Open Platform app
  • An MCP client such as Cursor (Agent mode) or Claude Desktop
1

Create a Feishu custom app

In the Feishu Open Platform (open.feishu.cn), create a self-built application. Navigate to Permissions & Scopes and grant the document read permission (docs:doc:readonly or equivalent). Note the App ID and App Secret.

2

Clone the repository

Download the server source.

git clone https://github.com/VienLi/lark-tools-mcp.git && cd lark-tools-mcp
3

Configure environment variables

Copy the example env file and fill in your Feishu app credentials.

cp .env.example .env
# Edit .env and set:
# FEISHU_APP_ID=cli_your_app_id
# FEISHU_APP_SECRET=your_app_secret
4

Install dependencies and start the server

Install packages with yarn and start the MCP server.

yarn install && yarn start
5

Add the server to your MCP client

Configure Cursor or Claude Desktop to connect to the running server. For Cursor, add the server to its MCP settings; for Claude Desktop, add the mcpServers block shown in the examples.

Lark Tools MCP Examples

Client configuration

Add to claude_desktop_config.json. Pass Feishu credentials as environment variables so the server can authenticate with the Feishu API.

{
  "mcpServers": {
    "lark-tools": {
      "command": "node",
      "args": ["/absolute/path/to/lark-tools-mcp/dist/index.js"],
      "env": {
        "FEISHU_APP_ID": "cli_your_feishu_app_id",
        "FEISHU_APP_SECRET": "your_feishu_app_secret"
      }
    }
  }
}

Prompts to try

Once connected, you can ask the AI to fetch Feishu documents by URL or document ID.

- "Fetch the Feishu document at https://your-company.feishu.cn/docs/ABC123 and summarise it"
- "Read the content of Feishu doc ID ABC123 and list all the action items"
- "Get the product spec document from Feishu and translate the requirements section into English"
- "Pull the meeting notes from this Feishu link and draft a follow-up email"

Troubleshooting Lark Tools MCP

Authentication error: invalid app_id or app_secret

Copy FEISHU_APP_ID and FEISHU_APP_SECRET exactly from the Feishu Open Platform console. Ensure the app is published (not in draft state) and that the credentials are for a self-built app, not a marketplace app.

get_feishu_doc returns permission denied

The custom app must be added as a collaborator on the specific document, or the document must be shared with the app via its service account. In Feishu, open the document, click Share, and add your app's bot account.

yarn start fails with 'Cannot find module'

Run 'yarn install' first to ensure all dependencies are downloaded. If the error persists, run 'yarn build' to compile TypeScript before starting, then reference the compiled output path in your client config.

Frequently Asked Questions about Lark Tools MCP

What is Lark Tools MCP?

Lark Tools MCP is a Model Context Protocol (MCP) server that lark-tools-mcp connects lark and cursor. it provides cursor with the ability to read documents, send messages, process tasks, and perform data analysis. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Lark Tools MCP?

Follow the installation instructions on the Lark Tools MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Lark Tools MCP?

Lark Tools MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Lark Tools MCP free to use?

Yes, Lark Tools MCP is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Communication MCP Servers

Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "lark-tools": { "command": "npx", "args": ["-y", "lark-tools"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Lark Tools MCP?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides