discord-list

List Discord servers, channels, and DMs accessible with a user token.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you quickly discover which Discord servers, channels, and DMs are accessible with your user token, enabling faster onboarding and configuration.

Core Features & Use Cases

  • Inventory of servers: Retrieve a list of all servers your token can access (including DMs by default).
  • Channel discovery: Enumerate channels within a specific server to plan moderation or data collection tasks.
  • DM overview: Show your direct message channels and their identities for quick outreach.
  • Use Case: Imagine you need to audit your Discord footprint across multiple servers; this skill provides an up-to-date inventory of servers, channels, and DMs you can access.

Quick Start

Use the discord-list skill to list all servers and channels you can access with your token.

  • List all servers (includes DMs by default): python ${CLAUDE_PLUGIN_ROOT}/tools/discord_list.py --servers
  • List servers only (exclude DMs): python ${CLAUDE_PLUGIN_ROOT}/tools/discord_list.py --servers --no-dms
  • List channels in a specific server: python ${CLAUDE_PLUGIN_ROOT}/tools/discord_list.py --channels SERVER_ID
  • List DMs only: python ${CLAUDE_PLUGIN_ROOT}/tools/discord_list.py --dms

Frequently Asked Questions about discord-list

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

FAQPage Schema
How do I list all Discord servers and channels accessible with my user token?

You can list Discord servers and channels by running a Python-based CLI utility that reads your DISCORD_USER_TOKEN from the environment and queries Discord endpoints to format an inventory of accessible guilds and direct messages.

Can I exclude direct messages when listing Discord servers?

Yes, you can exclude direct messages when listing Discord servers by passing the --no-dms flag to the CLI command, which filters out DM channels and returns only server entries.

What do I need to enumerate channels within a specific Discord server?

To enumerate channels within a specific Discord server, you need a valid Discord user token set in your environment and the target SERVER_ID, which you pass to the CLI utility to retrieve and format that guild's channel list.

How does a Discord server inventory help with auditing or moderation planning?

A Discord server inventory helps with auditing and moderation planning by providing an up-to-date list of accessible servers, channels, and DMs, allowing you to identify available resources and their IDs for automation tasks.

Does this Discord listing approach work for direct message channels?

Yes, the Discord listing approach works for direct message channels by default, and you can use a dedicated flag to list DMs only, showing your direct message channels and their identities for quick outreach.

What are the limitations of listing Discord channels with a user token?

Listing Discord channels with a user token is limited to the servers, channels, and DMs that the specific token can access, meaning any guilds or private channels where the token owner lacks membership or permissions will not appear in the inventory.