feishu-message — Claude Code skill: read Feishu messages
A skill that gives Claude Code access to Feishu messages: fetch a single message by ID or list recent messages from a chat with time filtering and sort options.
MIT 145 installs ★ 4,217 updated 2026-03-29
npx skills add m1heng/clawdbot-feishu --skill feishu-message -a claude-codeWhat feishu-message does
The skill adds the feishu_message tool to Claude Code with two operations. The get action retrieves a message by ID — the agent sends action: get with message_id and receives full text, type, sender ID, and metadata. The list action returns messages from a chat: omit parameters to get recent messages in the current chat, or specify chat_id, page size (up to 50), sort direction, and a time range in Unix seconds.
Access requires Feishu permissions: im:message or im:message:readonly for individual messages and direct messages, and im:message.group_at_msg:readonly to read all messages in group chats rather than just bot mentions. The skill is enabled by default in the channels.feishu.tools.message config.
What it helps with
- retrieve a Feishu message by ID or date
- extract chat history for a time period
- read and summarize a channel discussion
- collect mention text from a group chat
Example prompts for the agent
- Find message
om_5a123456and show me what it says - List the last 20 messages in this chat, oldest first
- Get all messages from January 1, 2025 between midnight and 11:59 PM
How to install feishu-message
1Skills CLI (Vercel)
npx skills add m1heng/clawdbot-feishu --skill feishu-message -a claude-code2Manually: put the files in place
~/.claude/skills/feishu-message/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/feishu-message/
1Skills CLI (Vercel)
npx skills add m1heng/clawdbot-feishu --skill feishu-message -a codex2Manually: put the files in place
.agents/skills/feishu-message/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add m1heng/clawdbot-feishu --skill feishu-message -a cursor2Manually: put the files in place
.cursor/skills/feishu-message/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install m1heng/clawdbot-feishu skills/feishu-message2Manually: put the files in place
.github/skills/feishu-message/SKILL.md1Skills CLI (Vercel)
npx skills add m1heng/clawdbot-feishu --skill feishu-message -a gemini-cli2Platform CLI
gemini skills install https://github.com/m1heng/clawdbot-feishu --path skills/feishu-messageManually: put the files in place
.devin/skills/feishu-message/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add m1heng/clawdbot-feishu --skill feishu-message -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about feishu-message
How do I install feishu-message in Claude Code?
Run npx skills add m1heng/clawdbot-feishu --skill feishu-message -a claude-code, then verify the skill is present at ~/.claude/skills/feishu-message/SKILL.md.
What does feishu-message do?
It gives Claude Code access to Feishu messages: you can request a single message by ID or fetch a list of recent messages with time filtering and sort options.
What permissions does the skill need?
It requires im:message or im:message:readonly for individual messages and direct messages. Add im:message.group_at_msg:readonly if you need to read all messages in group chats.
Source text
SKILL.md · MIT
---
name: feishu-message
description: |
Feishu message reading. Activate when user mentions reading messages, chat history, message lookup, or finding previous messages.
---
# Feishu Message Tool
Single tool `feishu_message` for reading Feishu messages — get a single message by ID or list recent messages in a chat.
## Actions
### Get Single Message
```json
{
"action": "get",
"message_id": "om_xxx"
}
```
Returns:
```json
{
"ok": true,
"action": "get",
"found": true,
"message_id": "om_xxx",
"msg_type": "text",
"content": "Hello world",
"sender_id": "ou_xxx",
"sender_type": "user",
"chat_id": "oc_xxx",
"create_time": "1710000000000",
"update_time": "1710000000000",
"mentions": []
}
```
### List Recent Messages
List recent messages in a chat (DM or group), newest first by default.
Omit `chat_id` to use the current conversation's chat:
```json
{
"action": "list"
}
```
With custom page size, sort order, and time range:
```json
{
"action": "list",
"chat_id": "oc_xxx",
"page_size": 20,
"sort_type": "ByCreateTimeAsc",
"start_time": "1710000000",
"end_time": "1710086400"
}
```
Returns:
```json
{
"ok": true,
"action": "list",
"chat_id": "oc_xxx",
"total": 10,
"messages": [
{
"message_id": "om_xxx",
"msg_type": "text",
"content_preview": "Hello world",
"sender_id": "ou_xxx",
"sender_type": "user",
"create_time": "1710000000000",
"chat_id": "oc_xxx"
}
]
}
```
## Parameters
| Parameter | Required | Description |
|-----------|----------|-------------|
| `action` | Yes | `get` or `list` |
| `message_id` | get: Yes | Feishu message ID (e.g., `om_xxx`) |
| `chat_id` | list: Optional | Chat ID (e.g., `oc_xxx`). Omit to use current chat. |
| `page_size` | list: Optional | Number of messages (default: 10, max: 50) |
| `sort_type` | list: Optional | `ByCreateTimeDesc` (default) or `ByCreateTimeAsc` |
| `start_time` | list: Optional | Unix timestamp in seconds (e.g., `"1710000000"`). No lower bound if omitted. |
| `end_time` | list: Optional | Unix timestamp in seconds (e.g., `"1710086400"`). No upper bound if omitted. |
## Configuration
```yaml
channels:
feishu:
tools:
message: true # default: true
```
## Permissions
- `im:message` or `im:message:readonly` — read single/DM messages
- `im:message.group_at_msg:readonly` — read all messages in group chats (not just @bot messages)
© m1heng · MIT · m1heng/clawdbot-feishu