majiayu000 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.