Discord User Token Sync

Syncs messages from Discord servers AND DMs using user token authentication.

When to Use

• Routed here by community-agent:discord-sync preflight check
• User explicitly asks for "user token sync"
• User wants to sync DMs (bots cannot access DMs)
• User wants rich profile data (bio, pronouns)

When NOT to Use

• User just says "sync discord" - use community-agent:discord-sync instead (it will route here if appropriate)
• User wants faster sync with bot token - use discord-bot-connector:discord-sync

Smart Defaults (Reduce Questions)

When user is vague, apply these defaults instead of asking:

User Says	Default Action
"sync my Discord"	Sync the configured default server from agents.yaml
"sync [server name]"	Find server by name, sync with 7 days default
No --days specified	Default to 7 days
"sync everything"	List available servers and ask user to pick

Only ask for clarification when:

• User's server name matches multiple servers
• User explicitly asks "which servers can I sync?"

How to Execute

Sync all channels in configured server:

python ${CLAUDE_PLUGIN_ROOT}/tools/discord_sync.py

Sync specific channel:

python ${CLAUDE_PLUGIN_ROOT}/tools/discord_sync.py --channel CHANNEL_ID

Sync specific 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 --days 7

Full re-sync (ignore previous sync state):

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

Sync DMs

DMs are included by default. Use --no-dms to sync servers only.

Sync all (servers + DMs):

python ${CLAUDE_PLUGIN_ROOT}/tools/discord_sync.py

Sync servers only (exclude DMs):

python ${CLAUDE_PLUGIN_ROOT}/tools/discord_sync.py --no-dms

Sync a specific DM by channel ID:

python ${CLAUDE_PLUGIN_ROOT}/tools/discord_sync.py --dm CHANNEL_ID

Sync DMs with custom message limit (default: 100):

python ${CLAUDE_PLUGIN_ROOT}/tools/discord_sync.py --dm-limit 500

DM Message Limits

DM Limit (--dm-limit)

• Default: 100 (privacy-conscious default)
• Lower than server channel limit by design
• Increase manually if needed: --dm-limit 500

Server Channel Limit (--limit)

• Default: 200 for quick mode
• Use config file to set higher limits for full sync

Output Location

All paths are relative to cwd (current working directory):

Server Messages

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

Sync state tracked in: ./data/{server_id}/sync_state.yaml

DM Messages

DM messages saved to: ./dms/discord/{user_id}-{username}/messages.md

DM manifest: ./dms/discord/manifest.yaml

Prerequisites

• ./.env file with DISCORD_USER_TOKEN set (in cwd)
• ./config/agents.yaml with discord.default_server_id configured (unless using --server flag)

Bot Token Alternative

For faster server message sync with higher rate limits (no DM access), use discord-bot-connector:discord-sync instead.

Incremental Sync

By default, sync is incremental - only new messages since last sync are fetched. Use --full to re-sync all messages within the date range.

Next Steps

After syncing, use discord-read skill to view or search messages.