list_team_members
Retrieve details of all members in a Microsoft Team, including names, email addresses, roles, and IDs, using the team ID for identification.
Instructions
List all members of a specific Microsoft Team. Returns member names, email addresses, roles, and IDs.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| teamId | Yes | Team ID |
Implementation Reference
- src/tools/teams.ts:727-770 (handler)The handler function for the 'list_team_members' tool. It fetches team members using the Microsoft Graph API endpoint `/teams/${teamId}/members`, maps the response to MemberSummary objects including id, displayName, and roles, handles empty results and errors, and returns a JSON-formatted text content block.async ({ teamId }) => { try { const client = await graphService.getClient(); const response = (await client .api(`/teams/${teamId}/members`) .get()) as GraphApiResponse<ConversationMember>; if (!response?.value?.length) { return { content: [ { type: "text", text: "No members found in this team.", }, ], }; } const memberList: MemberSummary[] = response.value.map((member: ConversationMember) => ({ id: member.id, displayName: member.displayName, roles: member.roles, })); return { content: [ { type: "text", text: JSON.stringify(memberList, 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:725-726 (schema)Zod input schema for the 'list_team_members' tool, requiring a 'teamId' string parameter.teamId: z.string().describe("Team ID"), },
- src/tools/teams.ts:722-771 (registration)Registration of the 'list_team_members' tool using server.tool() within the registerTeamsTools function, including name, description, input schema, and inline handler."list_team_members", "List all members of a specific Microsoft Team. Returns member names, email addresses, roles, and IDs.", { teamId: z.string().describe("Team ID"), }, async ({ teamId }) => { try { const client = await graphService.getClient(); const response = (await client .api(`/teams/${teamId}/members`) .get()) as GraphApiResponse<ConversationMember>; if (!response?.value?.length) { return { content: [ { type: "text", text: "No members found in this team.", }, ], }; } const memberList: MemberSummary[] = response.value.map((member: ConversationMember) => ({ id: member.id, displayName: member.displayName, roles: member.roles, })); return { content: [ { type: "text", text: JSON.stringify(memberList, null, 2), }, ], }; } catch (error: unknown) { const errorMessage = error instanceof Error ? error.message : "Unknown error occurred"; return { content: [ { type: "text", text: `❌ Error: ${errorMessage}`, }, ], }; } } );