m365-teams

name	m365-teams
description	Trigger this skill for Microsoft Teams collaboration — TEAMS, CHANNELS, MESSAGES, CHATS, and MEMBERS via the m365 CLI. Fire whenever a request is about: gửi/đọc tin nhắn trong channel (send/read channel messages), nhắn tin/chat 1:1 hoặc group chat với người khác, tạo/liệt kê team (create/list teams), tạo/xóa/quản lý channel (manage channels), thêm/bớt/xem thành viên team hoặc channel (members). Trigger phrases: "teams", "gửi tin nhắn teams", "nhắn qua teams", "chat teams", "channel", "kênh", "tạo team", "thành viên team", "member team", "danh sách team". Casual or unaccented phrasing still counts. This skill is about MESSAGING & team/channel structure, NOT file storage — for a team's documents / "Shared Documents" / Files tab use m365-sharepoint, and for personal OneDrive files use m365-onedrive. Non-Microsoft chat (Zalo, Slack) and Outlook email are out of scope.
allowed-tools	["Bash","Read"]

m365-teams — Microsoft Teams Management

Prerequisites

# Check m365 CLI installed
which m365 || echo "Chưa cài m365 CLI. Chạy: npm i -g @pnp/cli-microsoft365"

# Check logged in
m365 status || echo "Chưa đăng nhập. Chạy: m365 login"

For auth details, see ../m365-shared/references/authentication.md.

Operating Principles

• Output: always -o json with --query to filter fields
• IDs: most commands accept both --id and --name — prefer --name for readability, use --id when name is ambiguous
• Message content supports HTML: --message "<b>Bold</b> text"
• Destructive operations (remove): always confirm with user first

---

1. Team CRUD

List Teams

# All teams the user is a member of
m365 teams team list --joined -o json --query '[].{id:id, name:displayName, description:description}'

# All teams associated (including shared channels)
m365 teams team list --associated -o json --query '[].{id:id, name:displayName}'

# Another user's teams (requires Teams Admin role)
m365 teams team list --joined --userName [e-mail] -o json --query '[].{id:id, name:displayName}'

Get Team Details

# By name
m365 teams team get --name "Project Alpha" -o json

# By ID
m365 teams team get --id "TEAM_ID" -o json

Create Team

# Basic
m365 teams team add --name "New Team" --description "Description here" --ownerUserNames "[e-mail]" --wait -o json

# With members
m365 teams team add --name "New Team" --description "Desc" \
  --ownerUserNames "[e-mail]" \
  --memberUserNames "[e-mail],[e-mail]" \
  --wait -o json

# With multiple owners
m365 teams team add --name "New Team" --description "Desc" \
  --ownerEmails "[e-mail],[e-mail]" \
  --wait -o json

Without --wait, returns an async operation object. With --wait, waits for provisioning and returns the group resource.

---

2. Channels

List Channels

# All channels in a team
m365 teams channel list --teamName "Project Alpha" -o json --query '[].{id:id, name:displayName, type:membershipType}'

# Filter by type
m365 teams channel list --teamName "Project Alpha" --type private -o json --query '[].{id:id, name:displayName}'

Get Channel

# By name
m365 teams channel get --teamName "Project Alpha" --name "General" -o json

# Get the primary (General) channel
m365 teams channel get --teamName "Project Alpha" --primary -o json

Create Channel

# Standard channel
m365 teams channel add --teamName "Project Alpha" --name "Design" --description "Design discussions" -o json

# Private channel (requires --owner)
m365 teams channel add --teamName "Project Alpha" --name "Leadership" --type private --owner "[e-mail]" -o json

# Shared channel (requires --owner)
m365 teams channel add --teamName "Project Alpha" --name "Cross-team" --type shared --owner "[e-mail]" -o json

Remove Channel

m365 teams channel remove --teamId "TEAM_ID" --name "Old Channel" --force

---

3. Messages (Channel)

List Messages

# All messages in a channel (requires teamId + channelId)
m365 teams message list --teamId "TEAM_ID" --channelId "CHANNEL_ID" -o json \
  --query '[].{id:id, from:from.user.displayName, body:body.content, created:createdDateTime}'

# Messages since a date
m365 teams message list --teamId "TEAM_ID" --channelId "CHANNEL_ID" \
  --since "2024-01-01T00:00:00Z" -o json \
  --query '[].{id:id, from:from.user.displayName, body:body.content}'

Send Message

# Plain text
m365 teams message send --teamId "TEAM_ID" --channelId "CHANNEL_ID" --message "Hello team!"

# HTML content
m365 teams message send --teamId "TEAM_ID" --channelId "CHANNEL_ID" \
  --message "<h2>Update</h2><p>New release is ready</p>"

Get Message

m365 teams message get --teamId "TEAM_ID" --channelId "CHANNEL_ID" --id "MESSAGE_ID" -o json

Workflow: Gửi tin nhắn vào channel theo tên

# Step 1: Get team ID
TEAM_ID=$(m365 teams team get --name "Project Alpha" -o json --query 'id' | tr -d '"')

# Step 2: Get channel ID
CHANNEL_ID=$(m365 teams channel get --teamId "$TEAM_ID" --name "General" -o json --query 'id' | tr -d '"')

# Step 3: Send message
m365 teams message send --teamId "$TEAM_ID" --channelId "$CHANNEL_ID" --message "Hello!"

---

4. Chat (1:1 and Group)

List Chats

# All chats
m365 teams chat list -o json --query '[].{id:id, topic:topic, type:chatType}'

# Filter by type
m365 teams chat list --type oneOnOne -o json --query '[].{id:id, topic:topic}'
m365 teams chat list --type group -o json --query '[].{id:id, topic:topic}'

List Chat Messages

m365 teams chat message list --chatId "CHAT_ID" -o json \
  --query '[].{id:id, from:from.user.displayName, body:body.content, created:createdDateTime}'

Send Chat Message

# By chat ID
m365 teams chat message send --chatId "CHAT_ID" --message "Hi!"

# By email (creates new chat if none exists)
m365 teams chat message send --userEmails "[e-mail]" --message "Hi!"

# Group chat by emails
m365 teams chat message send --userEmails "[e-mail],[e-mail]" --message "Hello group!"

# By chat name
m365 teams chat message send --chatName "Project Chat" --message "Update here"

# HTML content
m365 teams chat message send --chatId "CHAT_ID" --message "<b>Important</b> update" --contentType html

NOTE: Chat message send only works with delegated permissions (not application). NOTE: Lệnh gửi thành công thường KHÔNG in stdout — dựa vào exit code (0 = đã gửi), đừng kỳ vọng JSON trả về.

---

5. Members

List Team Members

m365 teams user list --teamId "TEAM_ID" -o json --query '[].{id:id, name:displayName, email:userPrincipalName, role:userType}'

# Filter by role
m365 teams user list --teamId "TEAM_ID" --role Owner -o json --query '[].{name:displayName, email:userPrincipalName}'
m365 teams user list --teamId "TEAM_ID" --role Member -o json
m365 teams user list --teamId "TEAM_ID" --role Guest -o json

List Channel Members

m365 teams channel member list --teamName "Project Alpha" --channelName "General" -o json \
  --query '[].{id:id, name:displayName, email:email, role:roles}'

# Filter by role
m365 teams channel member list --teamName "Project Alpha" --channelName "Private Channel" --role owner -o json

Add Channel Member

# Add as member
m365 teams channel member add --teamName "Project Alpha" --channelName "Private Channel" \
  --userIds "[e-mail]"

# Add as owner
m365 teams channel member add --teamName "Project Alpha" --channelName "Private Channel" \
  --userIds "[e-mail]" --owner

# Add multiple
m365 teams channel member add --teamName "Project Alpha" --channelName "Private Channel" \
  --userIds "[e-mail],[e-mail]"

NOTE: You can only add team members to a private channel. Add them to the team first if needed.

---

References

File	Khi nào đọc
references/advanced-commands.md	Khi cần Tab, Meeting, App, Settings
../m365-shared/SKILL.md	Output format, JMESPath, error handling
../m365-shared/references/authentication.md	Auth methods chi tiết