# Discord List

> List Discord servers and channels. Use when user asks about available servers, channels, or wants to discover what's accessible.

- Skill: `lycfyi/discord-list` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add lycfyi/discord-list`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lycfyi/discord-list/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: lycfyi (https://skillmd.com/u/lycfyi)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/lycfyi/discord-list

---


# 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.