discord-sync

Sync Discord server and DM messages using a user token.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables seamless synchronization of Discord messages from both servers and direct messages using a user token, freeing you from manual copying and archiving tasks.

Core Features & Use Cases

  • User-token based sync: Sync rich message history from servers and DMs for archival and analysis.
  • Incremental/Full sync: Retrieve only new messages or re-sync entire histories as needed.
  • Profile enrichment: Access rich user profiles (bio, pronouns) when available to contextualize conversations.

Quick Start

  • Set your token: export DISCORD_USER_TOKEN=your_token
  • Ensure config file at ./config/agents.yaml with discord.default_server_id
  • Run: python ${CLAUDE_PLUGIN_ROOT}/tools/discord_sync.py

Frequently Asked Questions about discord-sync

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

FAQPage Schema
How do I sync Discord messages from servers and DMs using a user token?

Sync Discord messages by setting the DISCORD_USER_TOKEN environment variable, configuring agents.yaml with discord.default_server_id, and executing the Python sync script for incremental or full message retrieval.

What is user-token based Discord message synchronization?

User-token based Discord sync retrieves message histories from server channels and direct messages using your authentication token, enabling automated archival and analysis without manual copying.

Do I need a specific Discord server ID to sync messages?

Yes, message synchronization requires a configured agents.yaml file containing discord.default_server_id to target the correct server alongside your valid DISCORD_USER_TOKEN.

Can I retrieve only new Discord messages instead of the full history?

Yes, the Discord sync supports incremental synchronization to retrieve only new messages, alongside full sync mode to re-sync entire message histories from server channels and direct messages.

Does Discord message sync with a user token access rich profile information?

Yes, user-token based Discord sync accesses rich user profiles including bios and pronouns when available, helping contextualize archived conversations from server channels and direct messages.

Why is my Discord user token sync not working?

Discord user token sync fails when the DISCORD_USER_TOKEN environment variable is missing or invalid, or when agents.yaml lacks the required discord.default_server_id configuration.