List Slack Channels
slack_list_channelsList public and private channels that the bot is a member of or pre-defined channels in a Slack workspace, supporting pagination via limit and cursor.
Instructions
List public and private channels that the bot is a member of, or pre-defined channels in the workspace with pagination
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of channels to return (default 100, max 200) | |
| cursor | No | Pagination cursor for next page of results |
Implementation Reference
- index.ts:230-246 (handler)The handler function for slack_list_channels tool. Calls slackClient.getChannels() with limit and cursor, returns JSON-stringified response.
server.registerTool( "slack_list_channels", { title: "List Slack Channels", description: "List public and private channels that the bot is a member of, or pre-defined channels in the workspace with pagination", inputSchema: { limit: z.number().optional().default(100).describe("Maximum number of channels to return (default 100, max 200)"), cursor: z.string().optional().describe("Pagination cursor for next page of results"), }, }, async ({ limit, cursor }) => { const response = await slackClient.getChannels(limit, cursor); return { content: [{ type: "text", text: JSON.stringify(response) }], }; } ); - index.ts:63-109 (helper)The SlackClient.getChannels() method that executes the actual Slack API calls (conversations.list or conversations.info for predefined channels).
async getChannels(limit: number = 100, cursor?: string): Promise<any> { const predefinedChannelIds = process.env.SLACK_CHANNEL_IDS; if (!predefinedChannelIds) { const params = new URLSearchParams({ types: "public_channel,private_channel", exclude_archived: "true", limit: Math.min(limit, 200).toString(), team_id: process.env.SLACK_TEAM_ID!, }); if (cursor) { params.append("cursor", cursor); } const response = await fetch( `https://slack.com/api/conversations.list?${params}`, { headers: this.botHeaders }, ); return response.json(); } const predefinedChannelIdsArray = predefinedChannelIds.split(",").map((id: string) => id.trim()); const channels = []; for (const channelId of predefinedChannelIdsArray) { const params = new URLSearchParams({ channel: channelId, }); const response = await fetch( `https://slack.com/api/conversations.info?${params}`, { headers: this.botHeaders } ); const data = await response.json(); if (data.ok && data.channel && !data.channel.is_archived) { channels.push(data.channel); } } return { ok: true, channels: channels, response_metadata: { next_cursor: "" }, }; } - index.ts:235-238 (schema)Input schema for slack_list_channels using Zod: limit (optional number, default 100, max 200) and cursor (optional string for pagination).
inputSchema: { limit: z.number().optional().default(100).describe("Maximum number of channels to return (default 100, max 200)"), cursor: z.string().optional().describe("Pagination cursor for next page of results"), },