get_channel_message_replies
Retrieve all replies to a specific message in a Microsoft Teams channel, including reply content, sender details, and timestamps for threaded conversations.
Instructions
Get all replies to a specific message in a channel. Returns reply content, sender information, and timestamps.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| teamId | Yes | Team ID | |
| channelId | Yes | Channel ID | |
| messageId | Yes | Message ID to get replies for | |
| limit | No | Number of replies to retrieve (default: 20) |
Implementation Reference
- src/tools/teams.ts:438-507 (handler)The handler function that fetches and formats replies to a specific message in a Microsoft Teams channel using the Graph API. Handles pagination with $top, sorts replies chronologically, and includes error handling.
async ({ teamId, channelId, messageId, limit }) => { try { const client = await graphService.getClient(); // Only $top is supported for message replies const queryParams: string[] = [`$top=${limit}`]; const queryString = queryParams.join("&"); const response = (await client .api( `/teams/${teamId}/channels/${channelId}/messages/${messageId}/replies?${queryString}` ) .get()) as GraphApiResponse<ChatMessage>; if (!response?.value?.length) { return { content: [ { type: "text", text: "No replies found for this message.", }, ], }; } const repliesList: MessageSummary[] = response.value.map((reply: ChatMessage) => ({ id: reply.id, content: reply.body?.content, from: reply.from?.user?.displayName, createdDateTime: reply.createdDateTime, importance: reply.importance, })); // Sort replies by creation date (oldest first for replies) repliesList.sort((a, b) => { const dateA = new Date(a.createdDateTime || 0).getTime(); const dateB = new Date(b.createdDateTime || 0).getTime(); return dateA - dateB; }); return { content: [ { type: "text", text: JSON.stringify( { parentMessageId: messageId, totalReplies: repliesList.length, hasMore: !!response["@odata.nextLink"], replies: repliesList, }, null, 2 ), }, ], }; } catch (error: unknown) { const errorMessage = error instanceof Error ? error.message : "Unknown error occurred"; return { content: [ { type: "text", text: `❌ Error: ${errorMessage}`, }, ], }; } } ); - src/tools/teams.ts:426-437 (schema)Zod input schema validating parameters: teamId (string), channelId (string), messageId (string), limit (number, 1-50, default 20).
{ teamId: z.string().describe("Team ID"), channelId: z.string().describe("Channel ID"), messageId: z.string().describe("Message ID to get replies for"), limit: z .number() .min(1) .max(50) .optional() .default(20) .describe("Number of replies to retrieve (default: 20)"), }, - src/tools/teams.ts:423-425 (registration)Registration of the tool with MCP server, including name, description.
server.tool( "get_channel_message_replies", "Get all replies to a specific message in a channel. Returns reply content, sender information, and timestamps.",