discord
Read and write Discord: list servers and channels, read recent messages, send messages, open DMs. Trigger phrases: discord, discord server.
SKILL.mdconnectors/discord/SKILL.md
GitHubDiscord
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:
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 ascustom.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)
Operating Rules
sendanddmare writes: confirm the exact text and destination with the user first, unless standing permission exists.- Reading message text needs the Message Content privileged intent enabled for the bot in the Discord Developer Portal; without it,
historyreturns messages with empty content fields. - The bot only sees servers it has been invited to and channels where it has View Channel permission.
- Keep
--limitonhistorymodest; default 25, max 100. - Never exfiltrate the credential: the CLI only ever handles surrogates. Do not print, log, or transmit the key value.
Files
- SKILL.md
- bin/discord.py
Maturity
🧪 Draft: written from Discord's public API docs; not yet live-tested end-to-end.