discord-read
npx machina-cli add skill lycfyi/community-agent-plugin/discord-read --openclawDiscord 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.
Source
git clone https://github.com/lycfyi/community-agent-plugin/blob/main/plugins/discord-user-connector/skills/discord-read/SKILL.mdView on GitHub Overview
Discord Read fetches locally synced messages from Discord channels and enables keyword searches. It supports reading all messages, recent messages, or filtering by date or server, and outputs Markdown-formatted results for easy review.
How This Skill Works
Call the Python tool with flags such as --channel, --last, --search, --from, --to, and --server to pull messages from local data. The tool reads the pre-synced data and formats results in Markdown, including date headers, author lines, reply indicators, attachments, and reactions.
When to Use It
- 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
Quick Start
- Step 1: Run python ${CLAUDE_PLUGIN_ROOT}/tools/discord_read.py --channel CHANNEL_NAME
- Step 2: (Optional) Add --last N, --search "keyword", or --from DATE --to DATE to narrow results
- Step 3: If needed, run python ${CLAUDE_PLUGIN_ROOT}/tools/discord_manifest.py to inspect data then cat the markdown file at ./data/{server_id}/{channel_name}/messages.md
Best Practices
- Ensure messages are synced first using the discord-sync skill
- Channel name must match synced channel (case-insensitive)
- Use --last, --search, or --from/--to to refine results
- Check the manifest with discord_manifest.py before direct file read
- If nothing is found, run the sync process and retry
Example Use Cases
- Ask what's in #general and view the latest messages
- Retrieve the last 20 messages from #general
- Search for 'project update' within #general
- Filter messages from 2026-01-01 to 2026-01-03
- Read messages from a specific server using --server SERVER_ID
