List Tag Members

Retrieve members of a specified tag from Microsoft Teams via API.

Updated Feb 19, 2026
One-click install
npx skills add https://github.com/naftiko/microsoft-teams-sandbox --skill list-tag-members
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: List Tag Members
Source: https://github.com/naftiko/microsoft-teams-sandbox/tree/main/skills/list-teamwork-tag-members
Command: npx skills add https://github.com/naftiko/microsoft-teams-sandbox --skill list-tag-members

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you quickly identify all individuals associated with a specific tag within a Microsoft Teams team, streamlining communication and management efforts.

Core Features & Use Cases

  • Tag Membership Retrieval: Fetches a list of all members belonging to a designated tag.
  • Efficient Communication: Easily target specific groups for announcements or task assignments.
  • Use Case: A team lead needs to quickly find everyone tagged as 'Onboarding Specialists' to send them a relevant update.

Quick Start

Use the List Tag Members skill to find all members of the 'developers' tag in the 'Project Alpha' team.

Frequently Asked Questions about List Tag Members

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list members of a specific tag in Microsoft Teams?

You can list members of a specific tag in Microsoft Teams by querying the Teams API with valid team and tag IDs. This retrieves all users assigned that custom label for targeted outreach and communication management.

What do I need to retrieve Microsoft Teams tag members?

Retrieving Microsoft Teams tag members requires valid team and tag IDs, along with an access token possessing the 'TeamworkTag.Read' scope. These inputs allow you to authenticate and query the Microsoft Teams API successfully.

When do I need to fetch a list of members by tag in Microsoft Teams?

Fetching a list of members by tag in Microsoft Teams is needed when organizing users by custom labels for targeted outreach. It is useful for sending announcements or task assignments to specific groups, such as 'Onboarding Specialists'.

Does retrieving Microsoft Teams tags require specific API permissions?

Yes, retrieving Microsoft Teams tags requires an access token with the 'TeamworkTag.Read' scope. Without this specific API permission, you cannot authenticate or query the Microsoft Teams API to fetch tag membership lists.

What's the best way to organize users by custom labels in Microsoft Teams?

The best way to organize users by custom labels in Microsoft Teams is using tags. You can retrieve members of a specific tag through the Teams API to facilitate targeted communication, announcements, and task assignments.

Why does my Microsoft Teams tag members query fail?

Your Microsoft Teams tag members query may fail if the access token lacks the 'TeamworkTag.Read' scope, or if the provided team or tag IDs are invalid. Valid IDs and correct permissions are required to query the API.