Discord Sync

Discord Bot Token Sync

Syncs messages from Discord servers using bot token for higher rate limits and official API compliance.

When to Use

• Routed here by community-agent:discord-sync preflight check
• User explicitly asks for "bot token sync"
• User wants "faster sync" or "higher rate limits"
• Syncing large servers where rate limits matter

When NOT to Use

• User just says "sync discord" - use community-agent:discord-sync instead (it will route here if appropriate)
• User wants to sync DMs (bots cannot access DMs)
• User needs rich profile data (bio, pronouns)

Prerequisites

• .env with DISCORD_BOT_TOKEN set
• Bot added to the target server with these permissions:
  • Read Message History
  • View Channels

How to Execute

Sync all channels in a server:

python ${CLAUDE_PLUGIN_ROOT}/tools/discord_sync.py --server SERVER_ID

Sync with custom history range:

python ${CLAUDE_PLUGIN_ROOT}/tools/discord_sync.py --server SERVER_ID --days 7

Quick sync (limited messages per channel):

python ${CLAUDE_PLUGIN_ROOT}/tools/discord_sync.py --server SERVER_ID --quick

Full re-sync:

python ${CLAUDE_PLUGIN_ROOT}/tools/discord_sync.py --server SERVER_ID --full

Output Location

Messages saved to: ./data/discord/{server_id}-{slug}/{channel_name}/messages.md

This uses the same unified storage format as discord-user-connector, so messages from either connector are compatible.

Comparison with discord-user-connector:discord-sync

Limitations

• Cannot sync DMs - Bots cannot access user direct messages
• Cannot send as user - Messages sent by bot appear as bot
• Requires bot to be added to each server