discord-read

lycfyi's avatarfrom lycfyi

Read and search synced Discord messages. Use when user asks about discord conversations, wants to see messages, or search for specific content.

⭐2stars🔀0forks📁View on GitHub🕐Updated Jan 9, 2026

When & Why to Use This Skill

The Discord Read skill enables Claude to access, search, and analyze locally synced Discord message history. It provides a powerful interface for retrieving conversation context, filtering messages by date or keyword, and navigating channel logs directly within the AI environment, effectively turning Discord chats into a searchable knowledge base.

Use Cases

  • Catching up on discussions: Quickly summarize the last 20-50 messages in a specific channel to stay updated on team progress without manual scrolling.
  • Project tracking: Search for specific keywords like 'milestone' or 'deadline' across synced channels to find critical project updates and decisions.
  • Historical research: Use date-range filtering to retrieve conversations from specific timeframes, such as during a product launch or a technical incident.
  • Information retrieval: Find specific links, code snippets, or instructions shared by team members in Discord by searching through synced local logs.
namediscord-read
description"Read and search synced Discord messages. Use when user asks about discord conversations, wants to see messages, or search for specific content."

Discord Read

Read locally synced Discord messages and search for specific content.

When to Use

  • User asks "what's in #channel"
  • User asks about recent Discord conversations
  • User wants to search Discord messages
  • User asks "show me messages from Discord"
  • User wants to find specific Discord discussion

How to Execute

Read all messages from a channel:

python ${CLAUDE_PLUGIN_ROOT}/tools/discord_read.py --channel CHANNEL_NAME

Read last N messages:

python ${CLAUDE_PLUGIN_ROOT}/tools/discord_read.py --channel general --last 20

Search for keyword:

python ${CLAUDE_PLUGIN_ROOT}/tools/discord_read.py --channel general --search "project update"

Filter by date range:

python ${CLAUDE_PLUGIN_ROOT}/tools/discord_read.py --channel general --from 2026-01-01 --to 2026-01-03

Read from specific server:

python ${CLAUDE_PLUGIN_ROOT}/tools/discord_read.py --channel general --server SERVER_ID

Alternative: Direct File Read

For simpler access, first check what data exists using the manifest:

python ${CLAUDE_PLUGIN_ROOT}/tools/discord_manifest.py

Then read the markdown file directly (paths from manifest are relative to cwd):

cat ./data/{server_id}/{channel_name}/messages.md

Output Format

Messages are formatted in Markdown with:

  • Date headers (## YYYY-MM-DD)
  • Message headers (### Time - @author)
  • Reply indicators (↳ replying to @user)
  • Attachments and embeds
  • Reactions

Prerequisites

  • Messages must be synced first using discord-sync skill
  • Channel name must match synced channel (case-insensitive)

Error Handling

If messages are not found, the tool suggests running sync first.