discord-read

Read and search locally synced Discord messages with channel, server, and date filters.

5|1|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/lycfyi/community-agent-plugin --skill discord-read
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: discord-read
Source: https://github.com/lycfyi/community-agent-plugin/tree/main/plugins/discord-user-connector/skills/discord-read
Command: npx skills add https://github.com/lycfyi/community-agent-plugin --skill discord-read

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Read locally synced Discord messages and search for specific content, eliminating the need to switch between apps or manual logs to locate conversations.

Core Features & Use Cases

  • Read all messages from a channel to review conversation history.
  • Read last N messages to quickly catch up on recent activity.
  • Search for keywords across channels and servers to locate relevant discussions.
  • Filter by date range or server to narrow down results.

Quick Start

Use the discord-read skill to access messages from your configured Discord data store.

  • 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: You can inspect data via the manifest and read the stored messages from the data paths.

Frequently Asked Questions about discord-read

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search synced Discord messages for specific keywords?

You can read last N messages by passing the --last parameter with a number to the discord-read command. This fetches the most recent synced messages from a specified channel, allowing you to quickly catch up on recent activity.

Can I filter Discord channel messages by a specific date range?

Yes, you can filter Discord channel messages by date range using the --from and --to parameters. This narrows down the locally synced data to only show conversations that occurred within that specific timeframe.

Do I need to sync data before I can read Discord messages locally?

Yes, you must run the discord-sync skill first. The discord-read skill depends entirely on this pre-synced local data store to execute channel-level, server-level, and time-bounded message queries.

How do I read messages from a specific Discord server?

To read messages from a specific Discord server, execute the discord-read tool with the --server flag and provide the server ID. This filters your locally synced data to retrieve conversations only from that targeted server.

What is the best way to read all messages from a Discord channel?

The best way to read all messages from a Discord channel is to run the discord-read tool with the --channel flag. This pulls the complete conversation history from your locally synced data store without needing to switch apps.

Are there limitations to searching Discord messages without an active connection?

A limitation is that you can only query messages already captured by the sync process. If recent Discord messages were not synced, they will not appear in search or read results, meaning your data retrieval is bounded by the last sync execution.