Lark MCP Bridge
raynguyen256/Lark-CLI-MCP-Bridge
Integra Claude com Lark/Feishu para produtividade na suite colaborativa
Ver no GitHubMCP server que conecta Claude Desktop/Code com Lark/Feishu através do lark-cli. Permite acessar documentos, calendário, drive, mensagens e outras funcionalidades do Lark/Feishu diretamente do Claude com ferramentas nativas.
Instalação
npx convez-ai raynguyen256/Lark-CLI-MCP-Bridge1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Ler e editar documentos do Lark/Feishu via Claude
- Consultar calendário e agenda dentro de conversas com Claude
- Buscar arquivos no Drive do Lark/Feishu
- Enviar mensagens automáticas para usuários/grupos
- Automatizar fluxos que envolvem dados do Lark
Veredito

Solução sólida de integração para quem usa Lark/Feishu como suite colaborativa principal. Requer setup manual de credenciais e autenticação, mas oferece acesso bem estruturado às principais funcionalidades da plataforma através do Claude.
README
A tradução para o português deste README ainda está na fila.
Lark MCP Bridge — Hướng dẫn cài đặt và sử dụng
MCP server giúp Claude Desktop / Claude Code gọi trực tiếp vào Lark/Feishu thông qua lark-cli.
Yêu cầu hệ thống
- macOS (đã test) hoặc Linux
- Node.js ≥ 18
- Claude Desktop (hoặc bất kỳ MCP client nào)
Bước 1 — Cài Node.js
Kiểm tra Node.js đã có chưa:
node --version
Nếu chưa có, cài qua nvm (khuyến nghị):
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install 22
nvm use 22
Bước 2 — Cài Lark CLI
npm install -g lark-cli
Kiểm tra:
lark-cli --version
Bước 3 — Cấu hình ứng dụng Lark (App)
Chạy lệnh khởi tạo config:
lark-cli config init
CLI sẽ hỏi lần lượt:
? Select brand: › Lark
? App ID: cli_aa8f265206781ed2
? App Secret: <nhập App Secret của app "Lark MCP for PM">
Lưu ý: Khi được hỏi chọn app, chọn app Lark MCP for PM trên Lark Developer Console để lấy App ID và App Secret.
Kiểm tra config đã lưu:
lark-cli config show
Bước 4 — Đăng nhập tài khoản người dùng
Sau khi cấu hình app, cần đăng nhập để cấp quyền user:
lark-cli auth login
CLI sẽ trả về một URL xác thực, ví dụ:
Open this URL in your browser to authorize:
https://open.larksuite.com/open-apis/authen/v1/...
Mở URL đó trên trình duyệt → đăng nhập Lark → chấp nhận quyền → quay lại terminal.
Kiểm tra đăng nhập thành công:
lark-cli auth status
Kết quả mong đợi: hiển thị tên và email tài khoản Lark của bạn.
Bước 5 — Cài dependencies cho MCP Bridge
cd "/Users/nguyenan/Documents/Claude/Projects/Lark MCP"
npm install
Bước 6 — Đăng ký MCP vào Claude Desktop
Mở file config Claude Desktop:
~/Library/Application Support/Claude/claude_desktop_config.json
Thêm server lark-cli vào block mcpServers:
{
"mcpServers": {
"lark-cli": {
"command": "node",
"args": [
"/Users/nguyenan/Documents/Claude/Projects/Lark MCP/index.js"
]
}
}
}
Nếu file đã có
mcpServers, chỉ thêm block"lark-cli": { ... }vào bên trong — không xoá các server khác.
Bước 7 — Khởi động lại Claude Desktop
Thoát hoàn toàn và mở lại Claude Desktop.
Kiểm tra MCP đã được load: vào Settings → MCP, danh sách phải hiển thị lark-cli với trạng thái Connected.
Kiểm tra hoạt động
Thử tool cơ bản nhất trong Claude:
"Dùng lark_calendar_agenda xem lịch 3 ngày tới của tôi"
Hoặc:
"Dùng lark_drive_search tìm file tên 'Q2 Plan'"
Các công cụ (Tools) có sẵn
| Tool | Mô tả |
|---|---|
lark_docs_fetch | Đọc nội dung tài liệu Lark/Feishu (markdown hoặc XML) |
lark_docs_create | Tạo tài liệu mới |
lark_docs_update | Cập nhật tài liệu (append / overwrite / str_replace) |
lark_im_send | Gửi tin nhắn IM đến user hoặc group |
lark_drive_search | Tìm kiếm file trên Drive |
lark_calendar_agenda | Xem lịch sắp tới |
lark_cli_raw | Chạy bất kỳ lệnh lark-cli nào (nâng cao) |
Xử lý sự cố
"command not found: lark-cli"
Đường dẫn Node/npm chưa trong PATH. Tìm đường dẫn thực:
which lark-cli
Cập nhật biến LARK_CLI ở dòng đầu index.js thành đường dẫn tuyệt đối vừa tìm được.
"permission denied" hoặc lỗi scope
Chạy lại để cấp thêm quyền:
lark-cli auth login --scope "docx:document:readonly docs:document.content:write"
Token hết hạn
lark-cli auth logout
lark-cli auth login
Kiểm tra MCP server chạy thủ công
node "/Users/nguyenan/Documents/Claude/Projects/Lark MCP/index.js"
Server không có output khi chạy bình thường — nếu không có lỗi là OK.