> ## Documentation Index > Fetch the complete documentation index at: https://docs.boxd.sh/llms.txt > Use this file to discover all available pages before exploring further. # Microsoft Teams > Microsoft Teams integrates chat, video meetings, and file storage within Microsoft 365, providing virtual collaboration and communication for distributed teams Microsoft Teams integrates chat, video meetings, and file storage within Microsoft 365, providing virtual collaboration and communication for distributed teams `microsoft-teams` · **169 tools** · no triggers ## Connect it ```bash theme={"theme":"github-dark"} run auth microsoft-teams run auth microsoft-teams --scope team # shared with the organization ``` Or from the [Integrations page](https://app.boxd.sh/integrations) in the console. See [Connections](/guides/integrations/connections) for personal versus shared, and who may remove one. ## Use it ```bash theme={"theme":"github-dark"} run microsoft-teams # common commands run microsoft-teams --all # every command ``` ```ts theme={"theme":"github-dark"} import { microsoftTeams } from "@boxd/run"; ``` ## Common tools | Tool | What it does | | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | `add-chat-member` | Tool to add a conversationMember to a Microsoft Teams chat. Use when adding a user to an existing chat conversation. | | `add-member-to-channel` | Tool to add a member to a Microsoft Teams channel. Use this action when you need to grant a user access to a specific channel within a team, or when... | | `add-member-to-team` | (DEPRECATED: use `MICROSOFT_TEAMS_ADD_TEAM_MEMBER`) Tool to add a user to a Microsoft Teams team. | | `add-team-member` | Tool to add a user to a Microsoft Teams team. Use when granting or updating membership for a user. | | `add-team-members-bulk` | Tool to add multiple members to a Microsoft Teams team in a single operation. | | `archive-channel` | Tool to archive a channel in a Microsoft Teams team. Use when you need to archive a specific channel within a team. | | `archive-group-team-channel` | Tool to archive a channel in a Microsoft Teams team using the group ID. | | `archive-team` | Tool to archive a Microsoft Teams team. Use after confirming the team ID; returns 202 if accepted. | | `clone-team` | Tool to clone a Microsoft Teams team using the team ID. Use when you need to create a copy of an existing team including its structure, channels, and tabs. | | `create-call-operation` | Tool to create a new operation for a communications call. Use when you need to initiate a new operation on an active call. | | `create-meeting` | Use to schedule a new standalone Microsoft Teams online meeting, i.e., one not linked to any calendar event. | | `create-open-shift` | Tool to create a new open shift in a Microsoft Teams team schedule. | | `create-shift` | Tool to create a new shift in a Microsoft Teams team schedule. | | `create-team` | Tool to create a new Microsoft Teams team. Use when you need to provision a team with optional template, channels, and members. | | `create-team-from-group` | Tool to create a new team under an existing Microsoft 365 group. | | `create-time-off` | Tool to create a new timeOff instance in a team's schedule. Use when you need to create approved time off for a team member (vacation, sick leave, etc.). | | `create-time-off-reason` | Tool to create a new time off reason in a team's schedule. Use when you need to define a new category for time off requests with a custom name and icon. | | `delete-channel` | Tool to delete a channel from a Microsoft Teams team. Use when you need to permanently remove a channel. | | `delete-day-note` | Tool to delete a day note from a Microsoft Teams schedule. Use when you need to remove a day note from a specific date in the team schedule. | | `delete-open-shift` | Tool to delete an open shift from a Microsoft Teams schedule. | | `delete-scheduling-group` | Tool to delete a scheduling group from a Microsoft Teams team schedule. | | `delete-shift` | Tool to delete a shift from a Microsoft Teams team schedule. | | `delete-soft-message` | Tool to soft-delete a message in a Teams channel. Use when you need to remove a message without permanently deleting it. | | `delete-tab` | Tool to delete a tab from a Microsoft Teams channel. Use when you need to permanently remove a tab from a channel. | | `delete-team` | Tool to delete a Microsoft Teams team. Use after confirming the target team ID. | | Tool | What it does | | -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `add-chat-member` | Tool to add a conversationMember to a Microsoft Teams chat. Use when adding a user to an existing chat conversation. | | `add-member-to-channel` | Tool to add a member to a Microsoft Teams channel. Use this action when you need to grant a user access to a specific channel within a team, or when... | | `add-member-to-team` | (DEPRECATED: use `MICROSOFT_TEAMS_ADD_TEAM_MEMBER`) Tool to add a user to a Microsoft Teams team. | | `add-tab` | Tool to add a new tab to a Microsoft Teams channel. Use when you need to pin an app or website as a tab in a channel. | | `add-team-member` | Tool to add a user to a Microsoft Teams team. Use when granting or updating membership for a user. | | `add-team-members-bulk` | Tool to add multiple members to a Microsoft Teams team in a single operation. | | `archive-channel` | Tool to archive a channel in a Microsoft Teams team. Use when you need to archive a specific channel within a team. | | `archive-group-team-channel` | Tool to archive a channel in a Microsoft Teams team using the group ID. | | `archive-team` | Tool to archive a Microsoft Teams team. Use after confirming the team ID; returns 202 if accepted. | | `chats-get-all-chats` | Lists a specified user's Microsoft Teams chats, supporting filtering and property selection. | | `chats-get-all-messages` | DEPRECATED: Use ListUserChatMessages instead. Lists messages from a specified Microsoft Teams chat via the Microsoft Graph API. | | `clear-automatic-location` | Tool to clear the automatic location from a user's presence in Microsoft Teams. | | `clear-me-presence-user-preferred` | Tool to clear a user's preferred presence setting in Microsoft Teams. | | `clear-my-presence` | DEPRECATED: Use MICROSOFT\_TEAMS\_CLEAR\_PRESENCE instead. Tool to clear the authenticated user's presence session in Microsoft Teams. | | `clear-presence` | Tool to clear the presence information for a user's application presence session in Microsoft Teams. | | `clear-presence-automatic-location` | DEPRECATED: Use MICROSOFT\_TEAMS\_CLEAR\_AUTOMATIC\_LOCATION instead. | | `clear-presence-location` | Tool to clear the authenticated user's presence location. Use when you need to remove location information from the user's current presence status. | | `clone-team` | Tool to clone a Microsoft Teams team using the team ID. Use when you need to create a copy of an existing team including its structure, channels, and tabs. | | `create-call-operation` | Tool to create a new operation for a communications call. Use when you need to initiate a new operation on an active call. | | `create-channel` | Tool to create a new standard, private, or shared channel within a Microsoft Teams team. | | `create-content-sharing-session` | Tool to create a content sharing session in a Microsoft Teams call. | | `create-group-team-channel` | Tool to create a new channel in a group's associated team. Use when you have a group ID and need to create a channel in its team. | | `create-meeting` | Use to schedule a new standalone Microsoft Teams online meeting, i.e., one not linked to any calendar event. | | `create-offer-shift-request` | Tool to create a new offer shift request in a user's joined team schedule. | | `create-open-shift` | Tool to create a new open shift in a Microsoft Teams team schedule. | | `create-open-shift-change-request` | Tool to create a new open shift change request in a team schedule. | | `create-or-get-online-meeting` | Tool to create a new Microsoft Teams online meeting or retrieve an existing one based on externalId. | | `create-or-update-schedule` | Tool to create or replace a schedule object for a Microsoft Teams team. | | `create-schedule-day-note` | Tool to create a new day note in a team's schedule. Use when you need to add notes or reminders for a specific date in the team schedule. | | `create-scheduling-group` | Tool to create a new scheduling group in a team's schedule. Use when you need to organize team members into groups for shift scheduling and management. | | `create-shift` | Tool to create a new shift in a Microsoft Teams team schedule. | | `create-team` | Tool to create a new Microsoft Teams team. Use when you need to provision a team with optional template, channels, and members. | | `create-team-from-group` | Tool to create a new team under an existing Microsoft 365 group. | | `create-time-off` | Tool to create a new timeOff instance in a team's schedule. Use when you need to create approved time off for a team member (vacation, sick leave, etc.). | | `create-time-off-reason` | Tool to create a new time off reason in a team's schedule. Use when you need to define a new category for time off requests with a custom name and icon. | | `create-time-off-request` | Tool to create a new time off request in a team's schedule. Use when a team member needs to request time off for vacation, sick leave, or other absences. | | `create-user-online-meeting` | Tool to create a new Microsoft Teams online meeting for a specific user. | | `delete-call-operation` | Tool to delete a navigation property operation for a communications call. | | `delete-channel` | Tool to delete a channel from a Microsoft Teams team. Use when you need to permanently remove a channel. | | `delete-day-note` | Tool to delete a day note from a Microsoft Teams schedule. Use when you need to remove a day note from a specific date in the team schedule. | | `delete-open-shift` | Tool to delete an open shift from a Microsoft Teams schedule. | | `delete-scheduling-group` | Tool to delete a scheduling group from a Microsoft Teams team schedule. | | `delete-shift` | Tool to delete a shift from a Microsoft Teams team schedule. | | `delete-soft-message` | Tool to soft-delete a message in a Teams channel. Use when you need to remove a message without permanently deleting it. | | `delete-tab` | Tool to delete a tab from a Microsoft Teams channel. Use when you need to permanently remove a tab from a channel. | | `delete-team` | Tool to delete a Microsoft Teams team. Use after confirming the target team ID. | | `delete-time-off` | Tool to delete a timeOff from a team's schedule. Use when you need to remove a scheduled time off entry from a team member's schedule. | | `delete-time-off-reason` | Tool to delete a time off reason from a team's schedule. Use when you need to remove a time off reason. | | `delete-time-off-request` | Tool to delete a time off request from a Microsoft Teams team schedule. | | `delete-user-online-meeting` | Tool to delete an online meeting for a user. Use when you need to permanently remove an online meeting from a user's calendar. | | `get-call-operation` | Tool to get a specific commsOperation for a call. Use to check the status of long-running call operations. | | `get-channel` | Tool to get a specific channel in a team. Use after obtaining valid team and channel IDs to fetch channel details. | | `get-channel-message` | Retrieves a specific message from a Microsoft Teams channel using its Team, Channel, and Message IDs. | | `get-channel-message-reply` | Tool to retrieve a single reply to a message in a channel. Use when you need to get details of a specific reply message. | | `get-chat` | Tool to retrieve a single chat by ID. Use when you need to get details about a specific chat. | | `get-chat-last-message-preview` | DEPRECATED: Use MICROSOFT\_TEAMS\_GET\_CHAT instead. Tool to get lastMessagePreview from a chat. | | `get-chat-member` | Tool to get a specific conversation member from a Microsoft Teams chat. | | `get-chat-message` | Tool to get a specific chat message. Use after confirming chat\_id and message\_id. | | `get-day-note` | Tool to retrieve a specific day note from a team's schedule. | | `get-files-folder` | Tool to get the files folder (DriveItem) metadata for a specific channel in a Microsoft Teams team. | | `get-group-team-channel` | DEPRECATED: Use MICROSOFT\_TEAMS\_GET\_CHANNEL instead. Tool to get a specific channel from a group's team. | | `get-meeting-transcript-content` | Retrieve the raw text/vtt content for a Microsoft Teams meeting transcript. | | `get-my-profile` | Tool to retrieve a user's profile (id/UPN/mail/displayName). | | `get-offer-shift-request` | Tool to get a specific offer shift request from a Microsoft Teams schedule. | | `get-online-meeting` | Tool to retrieve details of a specific Microsoft Teams online meeting by its ID. | | `get-open-shift` | Tool to get a specific open shift from a Microsoft Teams schedule. | | `get-open-shift-change-request` | Tool to retrieve a specific open shift change request from a Microsoft Teams team's schedule. | | `get-presence` | Tool to get a specific user's presence information. Use when checking availability status, activity, or work location for a particular user. | | `get-primary-channel` | Tool to get the default (General) channel of a team. Use when you need to access the primary channel without knowing its channel ID. | | `get-schedule` | Tool to retrieve the properties and relationships of a schedule object. | | `get-scheduling-group` | Tool to retrieve a specific scheduling group from a Microsoft Teams team's schedule. | | `get-shift` | Tool to retrieve a shift by ID from a Microsoft Teams team schedule. | | `get-swap-shifts-change-request` | Tool to get a specific swap shift change request from a Microsoft Teams schedule. | | `get-tab` | Tool to get a specific tab in a Microsoft Teams channel. Use when you need to retrieve details of a particular tab. | | `get-team-from-group` | Tool to get a specific team. Use when full details of one team by ID are needed. | | `get-team-member` | Tool to get a specific conversation member from a team. Use when retrieving details about a team member by their membership ID. | | `get-team-operation` | Tool to retrieve the status of a Teams async operation using teamId and operationId. | | `get-teams-app-definition` | Tool to get an installed app in a Microsoft Teams team. Use when you need to retrieve details of a specific app installation. | | `get-team-template` | DEPRECATED: Use MICROSOFT\_TEAMS\_GET\_TEAM\_FROM\_GROUP with expand="template" instead. | | `get-time-off` | Tool to retrieve a specific time off entry from a Microsoft Teams team's schedule by ID. | | `get-time-off-reason` | Tool to get a specific time off reason from a team's schedule. | | `get-time-off-request` | Tool to retrieve a specific time off request from a team's schedule. | | `get-user-chat` | Tool to retrieve a specific chat for a user. Use when you need to get details about a chat that a specific user is part of. | | `get-user-teamwork` | Tool to get userTeamwork settings for a specified user, including Microsoft Teams region and locale. | | `hide-chat-for-user` | Tool to hide a Microsoft Teams chat for a specific user. Use when you need to hide a chat from a user's chat list. | | `list-associated-teams` | Tool to list teams that a user is associated with in Microsoft Teams. | | `list-channel-tabs` | Tool to list tabs from a Microsoft Teams channel. Use when you need to retrieve all tabs configured in a specific channel. | | `list-chat` | DEPRECATED: Use MICROSOFT\_TEAMS\_CHATS\_GET\_ALL\_CHATS instead. | | `list-chat-members` | DEPRECATED: Use MICROSOFT\_TEAMS\_USERS\_CHATS\_LIST\_MEMBERS instead. | | `list-communications-calls-operations` | Tool to list operations on a Microsoft Teams call. Use when you need to retrieve the status of long-running operations like adding large gallery... | | `list-deleted-teams` | Tool to list deleted Microsoft Teams and their properties. Use when you need to retrieve a list of teams that have been deleted. | | `list-group-team-channels` | DEPRECATED: Use MICROSOFT\_TEAMS\_LIST\_CHANNELS instead. Tool to list channels from a group's associated team. | | `list-group-team-operations` | Tool to list operations on a group's team. Use when you need to retrieve all async operations (such as team creation, archiving, channel creation)... | | `list-incoming-channels` | Tool to list incoming channels shared with a Microsoft Teams team. | | `list-installed-apps` | Tool to list apps installed in a Microsoft Teams team. Use when you need to retrieve the collection of apps installed in a specific team. | | `list-meeting-transcripts` | List meeting transcripts for a Microsoft Teams online meeting. | | `list-message-replies` | Tool to list all replies to a specific message in a Microsoft Teams channel. | | `list-offer-shift-requests` | Tool to list offer shift requests in a Microsoft Teams schedule. | | `list-online-meetings` | Look up a Microsoft Teams online meeting for a user by identifier. | | `list-open-shift-change-requests` | Tool to list open shift change requests in a Microsoft Teams schedule. | | `list-open-shifts` | Tool to list open shifts in a Microsoft Teams schedule. Use when you need to retrieve all unassigned open shifts for a team's schedule. | | `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'. | | `list-pinned-messages` | Tool to retrieve the list of pinned messages in a Microsoft Teams chat. | | `list-schedule-day-notes` | Tool to list all dayNotes from a team's schedule. Use when you need to retrieve all day notes or search/filter notes for specific dates in a team's schedule. | | `list-scheduling-groups` | Tool to list scheduling groups in a team's schedule. Use when you need to retrieve all scheduling groups for shift management and organization. | | `list-shifts` | Tool to list shifts in a Microsoft Teams schedule. Use when you need to retrieve all shifts for a team's schedule. | | `list-swap-shifts-change-requests` | Tool to list swap shift change requests in a Microsoft Teams schedule. | | `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-team-operations` | Tool to list operations from a team. Use when you need to retrieve all async operations (such as team creation, archiving, channel creation) for a specific team. | | `list-team-permission-grants` | Tool to list all resource-specific permission grants for a team with support for filtering, pagination, and sorting. | | `list-team-templates` | Tool to list available Microsoft Teams templates. Use when retrieving templates for team creation or customization workflows. | | `list-time-off` | Tool to list time off entries from a Microsoft Teams team's schedule. | | `list-time-off-reasons` | Tool to get time off reasons from a team's schedule. Use when you need to retrieve the list of available time off reasons for scheduling in Microsoft Teams. | | `list-time-off-requests` | Tool to retrieve a list of time off requests from a Microsoft Teams team's schedule. | | `list-user-chat-members` | Tool to list members of a specific chat for a user in Microsoft Teams. | | `list-user-chat-messages` | Tool to retrieve messages from a specific chat for a given user. | | `list-user-joined-teams` | Tool to list the Teams that a specified user is a direct member of (joined 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. | | `mark-chat-read-for-user` | Tool to mark a chat as read for a specific user in Microsoft Teams. | | `mark-chat-unread-for-user` | Marks a specific chat as unread for a user by setting the last read message timestamp. | | `pin-message` | Tool to pin a message in a Microsoft Teams chat. Use when you need to highlight an important message for quick access. | | `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. | | `provision-channel-email` | Tool to provision an email address for a Microsoft Teams channel. | | `remove-channel-email` | Tool to remove the email address of a channel in Microsoft Teams. | | `remove-chat-member` | Tool to remove a member from a Microsoft Teams chat. Use when you need to remove a user from a chat conversation. | | `remove-team-member` | Tool to remove a member from a Microsoft Teams team. Use when you need to remove a user from a team. | | `remove-team-members` | Tool to remove multiple members from a Microsoft Teams team in bulk. | | `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. | | `search-messages` | Search Microsoft Teams messages using powerful KQL syntax. Supports sender (from:), date filters (sent:), attachments, and boolean logic. | | `send-activity-notification` | Tool to send activity notifications to specified recipients in Microsoft Teams. | | `set-me-preferred-presence` | DEPRECATED: Use MICROSOFT\_TEAMS\_SET\_USER\_PREFERRED\_PRESENCE instead. | | `set-presence` | Tool to set the presence information for a user's application presence session. | | `set-presence-automatic-location` | Tool to set the automatic presence location (office/remote/timeOff) for a specified user. | | `set-presence-manual-location` | DEPRECATED: Use MICROSOFT\_TEAMS\_SET\_USER\_PRESENCE\_MANUAL\_LOCATION instead. | | `set-user-preferred-presence` | Tool to set the preferred availability and activity status for a user. | | `set-user-presence-manual-location` | Tool to set the manual presence location (office/remote/timeOff) for a specific user. | | `share-team-schedule` | Tool to share a Microsoft Teams schedule for a specified time range. | | `teams-create-channel` | (DEPRECATED: use `MICROSOFT_TEAMS_CREATE_CHANNEL`) Tool to create a new standard, private, or shared channel within a Microsoft Teams team. | | `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. | | `teams-list` | Retrieves Microsoft Teams accessible by the authenticated user, allowing filtering, property selection, and pagination. | | `teams-list-channel-messages` | Tool to list messages in a Teams channel when team\_id and channel\_id are known (no chat\_id required). | | `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... | | `teams-list-chat-messages` | DEPRECATED: Use ListUserChatMessages instead. Retrieves messages (newest first) from an existing and accessible Microsoft Teams one-on-one chat... | | `teams-post-channel-message` | Posts a new top-level message to a channel in Microsoft Teams (does NOT reply to an existing message). | | `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'. | | `teams-post-message-reply` | (DEPRECATED: use `MICROSOFT_TEAMS_POST_MESSAGE_REPLY`) Sends a reply to an existing message, identified by `message_id`, within a specific... | | `unarchive-channel` | Tool to unarchive a channel in a Microsoft Teams team. Use when you need to restore an archived channel to active state. | | `unarchive-group-team-channel` | Tool to unarchive a channel in a Microsoft Teams group's team. | | `unarchive-team` | Tool to unarchive a Microsoft Teams team. Use when you need to restore an archived team to active state. | | `unhide-chat-for-user` | Tool to unhide a chat for a specific user. Use when you need to make a hidden chat visible again in the user's chat list. | | `unpin-message` | Tool to unpin a message from a Microsoft Teams chat. Use when you need to remove a pinned message. | | `update-call` | Tool to update the navigation property calls in Microsoft Teams communications. | | `update-call-operation` | Tool to update the navigation property operations in communications. | | `update-call-participant` | Tool to update a participant in a Microsoft Teams call. Use when you need to modify participant properties such as lobby status. | | `update-channel` | Tool to update channel properties in a Microsoft Teams group. | | `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-chat` | Tool to update the properties of a chat. Use when you need to modify chat settings such as the topic. | | `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-content-sharing-session` | Tool to update a content sharing session in a Microsoft Teams call. | | `update-day-note` | Tool to update an existing day note in a team's schedule. Use when you need to modify notes or reminders for a specific date in the team schedule. | | `update-online-meeting` | Tool to update the properties of an existing Microsoft Teams online meeting. | | `update-open-shift` | Tool to update an existing open shift in a Microsoft Teams team schedule. | | `update-scheduling-group` | Tool to replace/update a scheduling group in a team's schedule. | | `update-tab` | Tool to update the properties of a tab in a Microsoft Teams channel. | | `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. | | `update-team-member` | Tool to update a team member's roles or properties in Microsoft Teams. | | `update-team-schedule-shift` | Tool to update an existing shift in a Microsoft Teams team schedule. | | `update-time-off` | Tool to replace an existing timeOff entry in a team's schedule. | | `update-time-off-reason` | Tool to update a time off reason in a team's schedule. Use when you need to modify the display name, icon, active status, or code of an existing time off reason. | [Open Microsoft Teams in the console →](https://app.boxd.sh/integrations/detail/microsoft_teams)