slack_get_users
Retrieve workspace user lists with profile details to identify team members and manage Slack interactions.
Instructions
Get a list of all users in the workspace with their basic profile information
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cursor | No | Pagination cursor for next page of results | |
| limit | No | Maximum number of users to return (default 100, max 200) |
Implementation Reference
- index.ts:516-525 (handler)Handler case in CallToolRequest that parses arguments, calls SlackClient.getUsers, and returns the JSON response.
case "slack_get_users": { const args = request.params.arguments as unknown as GetUsersArgs; const response = await slackClient.getUsers( args.limit, args.cursor, ); return { content: [{ type: "text", text: JSON.stringify(response) }], }; } - index.ts:178-196 (schema)Tool schema definition including name, description, and inputSchema for pagination.
const getUsersTool: Tool = { name: "slack_get_users", description: "Get a list of all users in the workspace with their basic profile information", inputSchema: { type: "object", properties: { cursor: { type: "string", description: "Pagination cursor for next page of results", }, limit: { type: "number", description: "Maximum number of users to return (default 100, max 200)", default: 100, }, }, }, }; - index.ts:353-368 (helper)SlackClient method implementing the core logic: calls Slack users.list API with pagination params.
async getUsers(limit: number = 100, cursor?: string): Promise<any> { const params = new URLSearchParams({ 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/users.list?${params}`, { headers: this.botHeaders, }); return response.json(); } - index.ts:570-580 (registration)Registration of the tool in the ListToolsRequest handler's tools array.
tools: [ listChannelsTool, postMessageTool, replyToThreadTool, addReactionTool, getChannelHistoryTool, getThreadRepliesTool, getUsersTool, getUserProfileTool, lookupUserByEmailTool, ], - index.ts:44-47 (schema)TypeScript interface for tool arguments used in handler type casting.
interface GetUsersArgs { cursor?: string; limit?: number; }