Lark MCP Server

MCP server for Lark Open Platform. Supports Claude Desktop (stdio) and HTTP multi-session transports. ~42 tools across messages, docs (Base/Bitable, Sheets, Documents), and tasks.

Setup

1. Create a Lark Internal App

• Go to https://open.larksuite.com/app → Create app → Internal app

• Note down App ID and App Secret

• Under "Permissions & Scopes", enable required permissions (see table below)

• Under "Version Management & Release", publish the app

2. Required Permissions

3. Install

npm install
npm run build

Related MCP server: lark-hermes-mcp

Environment Variables

Copy .env.example to .env and fill in your values:

cp .env.example .env
# Edit .env with your Lark app credentials

Usage

Claude Desktop (stdio)

Add to your Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "lark": {
      "command": "node",
      "args": ["/path/to/lark-mcp/dist/cli.js", "mcp"],
      "env": {
        "LARK_APP_ID": "cli_xxxx",
        "LARK_APP_SECRET": "xxxx"
      }
    }
  }
}

Or with CLI args:

node dist/cli.js mcp --app-id cli_xxxx --app-secret xxxx

HTTP Server (multi-session)

node dist/cli.js mcp --app-id cli_xxxx --app-secret xxxx --mode http --port 3000

Connect via MCP client to http://localhost:3000/mcp.

Docker

docker build -t lark-mcp .

# Using env file
docker run --rm --env-file .env -p 3000:3000 lark-mcp

# Or passing env vars directly
docker run --rm -e LARK_APP_ID=cli_xxxx -e LARK_APP_SECRET=xxxx lark-mcp

# HTTP mode
docker run --rm --env-file .env -p 3000:3000 lark-mcp --mode http

Available Tools & Presets

Presets

Use with: node dist/cli.js mcp --tools preset.readonly ...

Tool Reference

Messages (7 tools)

• lark_message_send — Send message to user or chat

• lark_message_get — Get message by ID

• lark_message_list — List messages in a chat

• lark_message_update — Edit a message

• lark_message_delete — Delete a message

• lark_message_reply — Reply to a message

• lark_message_forward — Forward a message

Chats (3 tools)

• lark_chat_list — List chats

• lark_chat_get — Get chat info

• lark_chat_members — List chat members

Base/Bitable (10 tools)

• lark_base_create, lark_base_get — App management

• lark_base_table_list, lark_base_table_create — Table management

• lark_base_record_list, lark_base_record_get, lark_base_record_create, lark_base_record_update, lark_base_record_delete — Record CRUD

• lark_base_field_list — List fields

Sheets (6 tools)

• lark_sheet_create, lark_sheet_get, lark_sheet_list — Spreadsheet management

• lark_sheet_values_read, lark_sheet_values_write, lark_sheet_values_append — Value operations

Documents (6 tools)

• lark_document_create, lark_document_get — Document management

• lark_document_content — Get raw text content

• lark_document_blocks_list, lark_document_block_create, lark_document_block_update — Block operations

Tasks (10 tools)

• lark_task_create, lark_task_get, lark_task_list, lark_task_update, lark_task_delete — Task CRUD

• lark_task_complete — Complete a task

• lark_task_add_members, lark_task_remove_members — Member management

• lark_tasklist_list, lark_tasklist_create — Tasklist management

List all tools

node dist/cli.js tools
node dist/cli.js tools --project messages

License

MIT