Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add m1heng/clawdbot-feishu --skill feishu-message -a claude-code
Open on GitHub

What 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_5a123456 and 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-code

2Manually: put the files in place

~/.claude/skills/feishu-message/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/feishu-message/

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

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set8

Project sponsors

Companies that keep this analytics open