lark-mcp

A Model Context Protocol (MCP) server for Feishu/Lark. Lets AI assistants (Cursor, Claude Desktop, etc.) search wiki pages and read/write Feishu documents on your behalf via OAuth.

Features

• search_wiki — Search documents in Feishu Wiki by keywords
• get_doc_content — Read a Feishu document or wiki page by URL
• create_doc — Create a new Feishu document (with optional Markdown content)
• update_doc — Replace or append content in an existing Feishu document (Markdown → Feishu blocks)

Requirements

• Node.js >= 18.14.1
• A Feishu open-platform app with the following permissions:
  • docx:document, docx:document:readonly
  • wiki:wiki:readonly
  • search:docs:read

Setup

1. Install dependencies:

   npm install
   

2. Copy the example environment file and fill in your credentials:

   cp .env.example .env
   

3. Start the MCP server:

   node index.mjs
   

Environment Variables

Cursor / Claude Desktop Integration

Add the following to your MCP config (e.g. ~/.cursor/mcp.json):

{
  "mcpServers": {
    "lark": {
      "command": "node",
      "args": ["/path/to/lark-mcp/index.mjs"],
      "env": {
        "LARK_APP_ID": "your_app_id",
        "LARK_APP_SECRET": "your_app_secret",
        "FEISHU_DOMAIN": "your-tenant.feishu.cn"
      }
    }
  }
}

License

MIT