playbooks

home / skills / lycfyi / community-agent-plugin / discord-list

discord-list skill

/plugins/discord-user-connector/skills/discord-list

This skill lists your available Discord servers, channels, and DMs, helping you discover access and IDs efficiently.

npx playbooks add skill lycfyi/community-agent-plugin --skill discord-list

Review the files below or copy the command above to add this skill to your agents.

Files (2)
SKILL.md
1.4 KB
---
name: discord-list
description: "List Discord servers and channels. Use when user asks about available servers, channels, or wants to discover what's accessible."
---

# 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):

```bash
python ${CLAUDE_PLUGIN_ROOT}/tools/discord_list.py --servers
```

### List servers only (exclude DMs):

```bash
python ${CLAUDE_PLUGIN_ROOT}/tools/discord_list.py --servers --no-dms
```

### List channels in a specific server:

```bash
python ${CLAUDE_PLUGIN_ROOT}/tools/discord_list.py --channels SERVER_ID
```

Replace `SERVER_ID` with the actual Discord server ID.

### List DMs only:

```bash
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.

Overview

This skill lists Discord servers, channels, and direct messages that are accessible with your user token. It helps you discover available servers, inspect which channels exist in a server, and retrieve IDs needed for automation or syncing. Use it when you need a concise inventory of your Discord access.

How this skill works

The skill runs as a simple CLI tool that queries Discord using the provided user token and enumerates guilds (servers), channels, and DM channels. It supports flags to show servers, channels for a specific server, or DMs only. The output is a formatted table containing IDs, names, and relevant metadata for easy copy-paste into other tools.

When to use it

  • You want to know which Discord servers your account can access.
  • You need a list of channels inside a specific server.
  • You need server, channel, or DM channel IDs for automation or APIs.
  • You want to audit accessible DMs and their channel IDs.
  • You plan to sync messages and need to identify targets first.

Best practices

  • Store your DISCORD_USER_TOKEN in a local .env file and restrict its access.
  • Run listing commands from a secure network location to protect credentials.
  • Use the --no-dms option when you only want server/guild listings to reduce noise.
  • Copy IDs directly from the output to avoid transcription errors.
  • After identifying targets, validate permissions before attempting message syncs or bulk operations.

Example use cases

  • Quickly enumerate all servers and channels to prepare a migration or archive.
  • Find the numeric server or channel ID required by a bot or integration.
  • List DM channel IDs to correlate messages with users for analysis.
  • Audit accessible servers and member counts for account housekeeping.
  • Identify channels to pass to a message-sync workflow that archives or processes chat history.

FAQ

What credentials are required to run the tool?

A valid Discord user token set in a .env file (DISCORD_USER_TOKEN) in the working directory is required.

Can I list channels for a specific server only?

Yes — the tool accepts a server ID argument to list channels for that server.

Will the tool expose private messages?

It lists DM channel IDs and associated user metadata accessible by the token; keep output and token secure.