Microsoft 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

run auth microsoft-teams
run auth microsoft-teams --scope team    # shared with the organization

Or from the Integrations page in the console. See Connections for personal versus shared, and who may remove one.

Use it

run microsoft-teams          # common commands
run microsoft-teams --all    # every command

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.

All 169 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-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 →

Getting started

Guides

Integrations and automations

Use cases

References

Microsoft Teams

Connect it

Use it

Common tools

​Connect it

​Use it

​Common tools

Connect it

Use it

Common tools