What token do I need?

A valid DISCORD_USER_TOKEN must be set in the .env file in the current working directory.

What does the output look like?

Returns a formatted table of: Servers (ID, name, member count); Channels (ID, name, category); DMs (Channel ID, User ID, Username, Display Name).

How do I exclude DMs from the list?

Run the servers listing with --servers and add --no-dms to exclude DMs, e.g., --servers --no-dms.

discord-list

npx machina-cli add skill lycfyi/community-agent-plugin/discord-list --openclaw

Files (1)

SKILL.md

1.4 KB

Discord List

Lists Discord servers, channels, and DMs accessible with your user token.

When to Use

User asks "what Discord servers do I have?"
User asks "what channels are in [server]?"
User wants to "list my Discord servers"
User wants to "show me Discord channels"
User needs to find server or channel IDs
User asks "list my Discord DMs"
User wants to find DM channel IDs

How to Execute

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

Replace SERVER_ID with the actual Discord server ID.

List DMs only:

python ${CLAUDE_PLUGIN_ROOT}/tools/discord_list.py --dms

Output

Returns a formatted table of:

Servers: ID, name, member count
Channels: ID, name, category
DMs: Channel ID, User ID, Username, Display Name

Prerequisites

./.env file with DISCORD_USER_TOKEN set (in cwd)
Network access to Discord

Next Steps

After listing channels, suggest syncing messages with discord-sync skill.

Source

git clone https://github.com/lycfyi/community-agent-plugin/blob/main/plugins/discord-user-connector/skills/discord-list/SKILL.md

View on GitHub

Overview

Discord List lists servers, channels, and DMs accessible with your user token. It helps you discover what you can access and provides IDs for downstream tasks. This is useful for auditing your Discord footprint and preparing integrations.

How This Skill Works

The skill uses a Python tool (discord_list.py) invoked via the CLI to enumerate servers, channels, and DMs your token can access. It can include DMs by default, and outputs a formatted table with IDs, names, and categories. Prerequisites include a valid DISCORD_USER_TOKEN in .env and network access to Discord.

When to Use It

To see which Discord servers you have access to.
To inspect which channels exist in a specific server.
To list all your Discord servers quickly.
To locate channel IDs for scripting or bot work.
To list your Direct Message (DM) channels and their IDs.

Quick Start

Step 1: Create or update the .env file in the current directory and set DISCORD_USER_TOKEN.
Step 2: List all servers (including DMs by default): python ${CLAUDE_PLUGIN_ROOT}/tools/discord_list.py --servers
Step 3: List channels in a server: python ${CLAUDE_PLUGIN_ROOT}/tools/discord_list.py --channels SERVER_ID

Best Practices

Ensure a valid DISCORD_USER_TOKEN is set in the .env file in the current working directory.
Run with --servers to list servers (DMs are included by default); use --no-dms to exclude DMs.
Use --channels SERVER_ID to drill down into a server's channels.
Review the formatted output to copy IDs for automation or integration tasks.
Verify you have network access and the token permissions needed to read servers, channels, and DMs.

Example Use Cases

What Discord servers do I have?
What channels are in 1234567890?
List my Discord servers
Show me Discord channels
Find DM channel IDs

Frequently Asked Questions

Add this skill to your agents