List Discord channels
TL;DR
About
Discord's developer API hands a server's channel list to a bot added to that server, and adding one takes the Manage Server permission. Without that, the list to work from is your own sidebar as your signed-in account sees it, scrolled to the bottom, since Discord only keeps the rows near the scroll position on the page. Say you are a plain member of a 120-channel modding server for a city-builder game and only care about #releases and the three channels under "Bug Reports". Grab the guildId from list_servers and run this once. A filter on category plus #releases leaves four URLs to feed read_messages every morning. If one of them is a forum, it needs list_forum_posts instead, and the output will not flag it because there is no channel type field. Folded categories are where people get caught out: Discord removes their already-read channels, so a category with collapsed true comes back short. Unfold it first.
Input
guildId requiredServer id, e.g. from discord.com/list_servers.
Output
guildId requiredchannels requiredChannels in sidebar order. The sidebar is scrolled top to bottom to cover rows the page renders lazily. Threads are not listed (a channel's thread rows are skipped).
categories requiredCategories in sidebar order.
Example output
Shape only: placeholder values generated from the output schema, not a real run.
{
"guildId": "abc123",
"channels": [
{
"url": "https://example.com/item/123",
"name": "Example",
"category": "…",
"channelId": "abc123"
}
],
"categories": [
{
"name": "Example",
"channelId": "abc123",
"collapsed": true
}
]
}FAQ
Read Discord messages
Reads the most recent messages of one Discord channel or direct message (author, timestamp, text), newest first, loading older ones until the requested count; complete says whether the whole history came back. Requires being signed in. A DM or group DM is read the same way: pass its url from discord.com/list_dms. It also reads a thread or a forum post, since both are channels in their own right: pass the post's url (from discord.com/list_forum_posts). To list the posts of a forum channel rather than its messages, use discord.com/list_forum_posts. To read several channels, run the script once per channel.
Search Discord server messages
Search one Discord server's message history with Discord's own search, as the signed-in account, newest first. Search by words (content), and narrow by authors, channels, mentioned users and content type, each given as ids: get user ids from discord.com/get_member_list and channel ids from discord.com/list_channels. Returns one page of up to 25 matching messages with their author, text, time and link, Discord's total count of matches, and next_offset to read the next page (null on the last one). Fails with a clear error when the browser is not signed in to Discord, when the account is not a member of the server or can see no text channel in it, or when Discord is still indexing the server. Direct messages are not searched.
Post a Discord message
Posts a text message, optionally with a file attached (the attachment file input, renamed with filename), in a Discord channel addressed by its URL. Requires being logged in to Discord. Returns `sent` plus the created message's messageId, channelId, timestamp and content as Discord stored it. The message is visible to everyone who can see the channel. Empty messages, messages over 2000 characters and forum channels are refused with a clear reason. Use dry_run to check a channel and message without posting.