# Discord

Read and write Discord: list servers and channels, read recent messages, send messages...

- Repository: https://github.com/Anil-matcha/awesome-muse-connectors (1403 stars)
- Category: Writing
- License: MIT
- Last updated: 2026-10-13
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add Anil-matcha/awesome-muse-connectors --skill discord -g -a claude-code -y`
Codex: `npx skills add Anil-matcha/awesome-muse-connectors --skill discord -g -a codex -y`
Cursor: `npx skills add Anil-matcha/awesome-muse-connectors --skill discord -g -a cursor -y`
Gemini CLI: `npx skills add Anil-matcha/awesome-muse-connectors --skill discord -g -a gemini-cli -y`

## Description

Read and write Discord: list servers and channels, read recent messages, send messages, open DMs. Trigger phrases: discord, discord server.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Discord

## Purpose
Read and write Discord through a bot token: list servers the bot belongs to, list channels in a server, read recent message history, post messages, and open a DM to send a message. Use when the user mentions Discord or a Discord server.

## Tooling
All commands go through `bin/discord.py`:

```bash
bin/discord.py auth                                   # verify the bot token
bin/discord.py guilds                                 # list servers the bot joined
bin/discord.py channels --guild 112233445566778899    # list channels in a server
bin/discord.py history --channel 112233445566778899 --limit 25  # read recent messages
bin/discord.py send --channel 112233445566778899 --text "Ship it"  # post a message
bin/discord.py dm --user 112233445566778899 --text "Hi"            # open a DM and send
```

IDs are the numeric Discord snowflakes; copy them from `guilds`, `channels`, or Discord's Copy ID menu.

## Auth
- Provider id: `discord` (credential is collected as `custom.discord`)
- Collection: bot token via the secure credential flow (`credentials.request_api_access`); create the application at the Discord Developer Portal, copy the bot token, and invite the bot to each server with View Channel and Send Messages permissions
- Scopes: none (bot token auth)
- Allowed hosts: `discord.com`
- Status check: `bin/discord.py auth` (must return `"ok": true`)

The rest: https://github.com/Anil-matcha/awesome-muse-connectors/blob/HEAD/connectors/discord/SKILL.md
