n8n-nodes-lark

This is an n8n community node that integrates with Lark/Feishu using the official @larksuiteoapi/node-sdk.

Lark (known as Feishu in China) is a collaboration suite that includes messaging, video conferencing, calendar, docs, and more.

n8n is a fair-code licensed workflow automation platform.

Installation

Follow the installation guide in the n8n community nodes documentation.

1. Go to Settings > Community Nodes.
2. Select Install.
3. Enter @emu2025/n8n-nodes-lark in Enter npm package name.
4. Agree to the risks of using community nodes.
5. Select Install.

After installing the node, you can use it in your n8n workflows.

Credentials

To use this node, you need to set up Lark API credentials:

1. Go to Lark Open Platform (or Feishu Open Platform for China)
2. Create an application or select an existing one
3. Get your App ID and App Secret from the app credentials page
4. In n8n, create a new Lark API credential with these values
5. Select the appropriate domain (Lark for global, Feishu for China)

Supported Resources

Message

• Send: Send messages to users or chats
  • Supports text, post, image, and interactive message types
  • Multiple receiver ID types (open_id, user_id, union_id, email, chat_id)

User

• Get: Retrieve user information by user ID

Chat

• Get: Get chat information by chat ID
• List: List all chats

Document

• Create: Create a new document/folder
• Get Content: Get document content
• Get Raw Content: Get document raw content
• Update: Update document content using batch operations

Bitable (Multi-dimensional Table)

• Create Table: Create a new table in a bitable
• List Tables: List all tables in a bitable
• Add Record: Add a new record to a table
• Get Record: Get a specific record from a table
• List Records: List all records in a table with pagination
• Update Record: Update an existing record
• Delete Record: Delete a record from a table

Usage Example

Send a Text Message

1. Add the Lark node to your workflow
2. Select Message as the resource
3. Select Send as the operation
4. Choose the Receive ID Type (e.g., open_id)
5. Enter the Receive ID
6. Select Text as the message type
7. Enter your message content:

   {
     "text": "Hello from n8n!"
   }
   

Get User Information

1. Add the Lark node to your workflow
2. Select User as the resource
3. Select Get as the operation
4. Choose the User ID Type
5. Enter the User ID

Work with Bitable (Multi-dimensional Table)

1. Add the Lark node to your workflow
2. Select Bitable as the resource
3. Select Add Record as the operation
4. Enter the App Token (from the bitable URL)
5. Enter the Table ID
6. Enter the record fields in JSON format:

   {
     "Name": "John Doe",
     "Age": 30,
     "Department": "Engineering"
   }
   

For more detailed examples and use cases, see EXAMPLES.md.

Publishing

Ready to publish your own version? See:

• 🚀 Quick Start Guide - Fast track to publishing
• 📋 Publishing Guide - Detailed step-by-step instructions
• ✅ Publish Checklist - Pre-publish verification
• 📣 Promotion Guide - Marketing your node

Quick publish:

./scripts/publish.sh

Development

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode with watch
npm run dev

# Format code
npm run format

# Lint code
npm run lint

Resources

• n8n community nodes documentation
• Lark Open Platform
• Lark Node SDK

License

MIT