# Microsoft Teams

Microsoft Teams integrates chat, video meetings, and file storage within Microsoft 365, providing virtual collaboration and communication for distributed teams

- **Category:** team chat
- **Auth:** OAUTH2
- **Tools:** 34
- **Triggers:** 0
- **Slug:** `MICROSOFT_TEAMS`
- **Version:** 20260217_00

## Tools

### Add member to team

**Slug:** `MICROSOFT_TEAMS_ADD_MEMBER_TO_TEAM`

Tool to add a user to a Microsoft Teams team. Use when granting or updating membership for a user.

### Archive Teams team

**Slug:** `MICROSOFT_TEAMS_ARCHIVE_TEAM`

Tool to archive a Microsoft Teams team. Use after confirming the team ID; returns 202 if accepted.

### Get all chats

**Slug:** `MICROSOFT_TEAMS_CHATS_GET_ALL_CHATS`

Retrieves all Microsoft Teams chats a specified user is part of, supporting filtering, property selection, and pagination.

### Get all chat messages

**Slug:** `MICROSOFT_TEAMS_CHATS_GET_ALL_MESSAGES`

Retrieves all messages from a specified Microsoft Teams chat using the Microsoft Graph API, automatically handling pagination; ensure `chat_id` is valid and OData expressions in `filter` or `select` are correct.

### Create online meeting

**Slug:** `MICROSOFT_TEAMS_CREATE_MEETING`

Use to schedule a new standalone Microsoft Teams online meeting, i.e., one not linked to any calendar event.

### Create Team

**Slug:** `MICROSOFT_TEAMS_CREATE_TEAM`

Tool to create a new Microsoft Teams team. Use when you need to provision a team with optional template, channels, and members.

### Delete Teams team

**Slug:** `MICROSOFT_TEAMS_DELETE_TEAM`

Tool to delete a Microsoft Teams team. Use after confirming the target team ID.

### Get team channel

**Slug:** `MICROSOFT_TEAMS_GET_CHANNEL`

Tool to get a specific channel in a team. Use after obtaining valid team and channel IDs to fetch channel details.

### Get chat message

**Slug:** `MICROSOFT_TEAMS_GET_CHAT_MESSAGE`

Tool to get a specific chat message. Use after confirming chat_id and message_id.

### Get My Profile

**Slug:** `MICROSOFT_TEAMS_GET_MY_PROFILE`

Tool to retrieve the authenticated user's profile (id/UPN/mail/displayName). Use when operations require explicitly including the caller (e.g., chat creation) or when the user's identity is needed.

### Get Team

**Slug:** `MICROSOFT_TEAMS_GET_TEAM`

Tool to get a specific team. Use when full details of one team by ID are needed.

### Get Team Operation Status

**Slug:** `MICROSOFT_TEAMS_GET_TEAM_OPERATION`

Tool to retrieve the status of a Teams async operation using teamId and operationId. Use when you need to poll and track the progress of long-running operations like team creation or archiving. Microsoft recommends waiting at least 30 seconds between polling requests.

### List message replies

**Slug:** `MICROSOFT_TEAMS_LIST_MESSAGE_REPLIES`

Tool to list replies to a channel message. Use after obtaining team, channel, and message IDs.

### List team members

**Slug:** `MICROSOFT_TEAMS_LIST_TEAM_MEMBERS`

Tool to list members of a Microsoft Teams team. Use when you need to retrieve the members of a specific team, for auditing or notifications.

### List Teams templates

**Slug:** `MICROSOFT_TEAMS_LIST_TEAMS_TEMPLATES`

Tool to list available Microsoft Teams templates. Use when retrieving templates for team creation or customization workflows.

### List user joined teams

**Slug:** `MICROSOFT_TEAMS_LIST_USER_JOINED_TEAMS`

Tool to list the Teams that a specified user is a direct member of (joined teams). Use for access/membership audits when enumerating team members is access-restricted.

### List users

**Slug:** `MICROSOFT_TEAMS_LIST_USERS`

Tool to list all users in the organization. Use when you need to retrieve directory users with filtering, pagination, and field selection.

### Search Teams files

**Slug:** `MICROSOFT_TEAMS_SEARCH_FILES`

Search files in Microsoft Teams using KQL syntax. Find files by name, type, content, author, and modification date across all Teams and channels. Supports boolean logic and date ranges. Examples: 'filetype:pdf AND lastmodifiedtime>=2024-10-01', 'contract AND budget', 'filename:report AND author:user@example.com'

### Search Teams messages

**Slug:** `MICROSOFT_TEAMS_SEARCH_MESSAGES`

Search Microsoft Teams messages using powerful KQL syntax. Supports sender (from:), date filters (sent:), attachments, and boolean logic. Works across all Teams chats and channels the user has access to. Examples: 'from:user@example.com AND sent>=2024-10-01', 'punchlist OR termination', 'sent>today-30 AND hasattachment:yes' NOTE: This action requires an organizational Microsoft 365 account (Azure AD/Entra ID). It does NOT work with personal Microsoft accounts (MSA) such as @outlook.com, @hotmail.com, or @live.com. If using a personal Microsoft account, this search will fail.

### Create a channel

**Slug:** `MICROSOFT_TEAMS_TEAMS_CREATE_CHANNEL`

Creates a new 'standard', 'private', or 'shared' channel within a specified Microsoft Teams team.

### Create Chat

**Slug:** `MICROSOFT_TEAMS_TEAMS_CREATE_CHAT`

Creates a new chat; if a 'oneOnOne' chat with the specified members already exists, its details are returned, while 'group' chats are always newly created. IMPORTANT: The authenticated user MUST be included as one of the members.

### Get Teams message

**Slug:** `MICROSOFT_TEAMS_TEAMS_GET_MESSAGE`

Retrieves a specific message from a Microsoft Teams channel using its Team, Channel, and Message IDs.

### List Teams

**Slug:** `MICROSOFT_TEAMS_TEAMS_LIST`

Retrieves Microsoft Teams accessible by the authenticated user, allowing filtering, property selection, and pagination.

### List channel messages

**Slug:** `MICROSOFT_TEAMS_TEAMS_LIST_CHANNEL_MESSAGES`

Tool to list messages in a Teams channel when team_id and channel_id are known (no chat_id required). Use this to enumerate channel message history and obtain message_id for follow-on operations like listing replies or getting message details.

### List team channels

**Slug:** `MICROSOFT_TEAMS_TEAMS_LIST_CHANNELS`

Retrieves channels for a specified Microsoft Teams team ID (must be valid and for an existing team), with options to include shared channels, filter results, and select properties.

### List chat messages

**Slug:** `MICROSOFT_TEAMS_TEAMS_LIST_CHAT_MESSAGES`

Retrieves messages (newest first) from an existing and accessible Microsoft Teams one-on-one chat, group chat, or channel thread, specified by `chat_id`.

### List People

**Slug:** `MICROSOFT_TEAMS_TEAMS_LIST_PEOPLE`

Retrieves a list of people relevant to a specified user from Microsoft Graph, noting the `search` parameter is only effective if `user_id` is 'me'.

### Post message to Teams channel

**Slug:** `MICROSOFT_TEAMS_TEAMS_POST_CHANNEL_MESSAGE`

Posts a new text or HTML message to a specified channel in a Microsoft Teams team.

### Send message to Teams chat

**Slug:** `MICROSOFT_TEAMS_TEAMS_POST_CHAT_MESSAGE`

Sends a non-empty message (text or HTML) to a specified, existing Microsoft Teams chat; content must be valid HTML if `content_type` is 'html'.

### Reply to Teams channel message

**Slug:** `MICROSOFT_TEAMS_TEAMS_POST_MESSAGE_REPLY`

Sends a reply to an existing message, identified by `message_id`, within a specific `channel_id` of a given `team_id` in Microsoft Teams.

### Unarchive Teams team

**Slug:** `MICROSOFT_TEAMS_UNARCHIVE_TEAM`

Tool to unarchive a Microsoft Teams team. Use when you need to restore an archived team to active state.

### Update Teams channel message

**Slug:** `MICROSOFT_TEAMS_UPDATE_CHANNEL_MESSAGE`

Tool to update a message in a channel. Use when you need to modify an existing channel message after confirming channel and message IDs.

### Update Teams chat message

**Slug:** `MICROSOFT_TEAMS_UPDATE_CHAT_MESSAGE`

Tool to update a specific message in a chat. Use when you need to correct or modify a sent chat message.

### Update Team

**Slug:** `MICROSOFT_TEAMS_UPDATE_TEAM`

Tool to update the properties of a team. Use when you need to modify team settings such as member, messaging, or fun settings.
