name: discord-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.