discord-read
Read and search synced Discord messages. Use when user asks about discord conversations, wants to see messages, or search for specific content.
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.
| 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.