Microsoft Teams for AI agents

Agents read Microsoft Teams at once. Changes and sends are held for a person's approval by default.

Book a discovery call Browse all connectors

About Microsoft Teams

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

What an agent can do in Microsoft Teams

Every Microsoft Teams action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.

Runs at once (reads)

Looks things up in Microsoft Teams without asking first. 81 actions.

Get team channelTool to get a specific channel in a team. Use after obtaining valid team and channel IDs to fetch channel details.
Get chat messageTool to get a specific chat message. Use after confirming chat_id and message_id.
Get meeting transcript contentRetrieve the raw content for a Microsoft Teams meeting transcript, with or without speaker attribution. Use this after listing meeting transcripts and selecting a transcript ID. The Microsoft Graph tr
Get User ProfileTool to retrieve a user's profile (id/UPN/mail/displayName). Supports both delegated auth (use user_id='me') and application-only auth (specify user ID/UPN). Use when operations require user identity
Get primary channelTool to get the default (General) channel of a team. Use when you need to access the primary channel without knowing its channel ID.
Get scheduleTool to retrieve the properties and relationships of a schedule object. Use when you need to get schedule configuration details for a team.
Get TeamTool to get a specific team. Use when full details of one team by ID are needed.
Get Team Operation StatusTool 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. Micros
Get time off reasonTool to get a specific time off reason from a team's schedule. Use when you need to retrieve details about a time off reason including its display name, icon type, and active status.
List Communications Call OperationsTool to list operations on a Microsoft Teams call. Use when you need to retrieve the status of long-running operations like adding large gallery views, recording, or playing prompts on an active call.
List Group Team OperationsTool to list operations on a group's team. Use when you need to retrieve all async operations (such as team creation, archiving, channel creation) for a specific group's team.
List meeting recordingsList recordings for a scheduled, non-expired Microsoft Teams online meeting. Returns recording metadata, including IDs needed by the recording-content action. Microsoft Graph excludes live events and

Show all 81

List meeting transcriptsList meeting transcripts for a Microsoft Teams online meeting. Retrieves all transcripts associated with a specific meeting, including metadata such as creation time, meeting organizer, and content UR
List team membersTool 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 OperationsTool 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 user's chat membersTool to list members of a specific chat for a user in Microsoft Teams. Use when you need to retrieve the members of a specific user's chat, whether it's a one-on-one chat, group chat, or meeting chat.
Search Teams filesSearch 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: 'fil
Search Teams messagesSearch Microsoft Teams messages using KQL syntax. Supports sender (from:), date filters (sent:), attachments, and boolean logic. Works across all Teams chats and channels the user has access to, inclu
List channel messagesTool 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
Who Am IReturn the identity (email, name) of the connected Microsoft Teams account.
Get all chatsLists a specified user's Microsoft Teams chats, supporting filtering and property selection. An unfiltered first page for `user_id='me'` includes the personal self-chat with `is_self_chat=true`; use S
Get call operationTool to get a specific commsOperation for a call. Use to check the status of long-running call operations.
Get Teams channel messageRetrieves a specific message from a Microsoft Teams channel using its Team, Channel, and Message IDs.
Get chatTool to retrieve a single chat by ID. Use when you need to get details about a specific chat.
Get chat memberTool to get a specific conversation member from a Microsoft Teams chat. Use when you need details about a specific chat participant.
Get day noteTool to retrieve a specific day note from a team's schedule. Use when you need to view notes for a specific date in a team's schedule.
Get channel files folderTool to get the files folder (DriveItem) metadata for a specific channel in a Microsoft Teams team. Use when you need to access file storage information for a channel.
Get offer shift requestTool to get a specific offer shift request from a Microsoft Teams schedule. Use when you need to retrieve details of a single offer shift request by its ID.
Get online meetingTool to retrieve details of a specific Microsoft Teams online meeting by its ID. Use when you need to get the properties and relationships of an existing meeting.
Get open shiftTool to get a specific open shift from a Microsoft Teams schedule. Use when you need to retrieve details about a particular unassigned open shift by its ID.
Get open shift change requestTool to retrieve a specific open shift change request from a Microsoft Teams team's schedule. Use when you need to get details about a particular open shift request including its state, sender, and ma
Get User PresenceTool to get a specific user's presence information. Use when checking availability status, activity, or work location for a particular user.
Get scheduling groupTool to retrieve a specific scheduling group from a Microsoft Teams team's schedule. Use when you need to get details about a scheduling group including its members, status, and metadata.
Get shiftTool to retrieve a shift by ID from a Microsoft Teams team schedule. Use when you need to get details of a specific shift assignment.
Get site drive itemGet metadata for a known item in a SharePoint site's default document library.
Get swap shifts change requestTool to get a specific swap shift change request from a Microsoft Teams schedule. Use when you need to retrieve details of a single swap shift change request by its ID.
Get channel tabTool to get a specific tab in a Microsoft Teams channel. Use when you need to retrieve details of a particular tab.
Get team by IDRetrieve a Microsoft Teams team directly by team ID, optionally selecting properties or expanding related resources.
Get team memberTool to get a specific conversation member from a team. Use when retrieving details about a team member by their membership ID.
Get installed app in teamTool to get an installed app in a Microsoft Teams team. Use when you need to retrieve details of a specific app installation.
Get time off by IDTool to retrieve a specific time off entry from a Microsoft Teams team's schedule by ID. Use when you need to get details about a particular time off period including its dates, reason, and status.
Get time off requestTool to retrieve a specific time off request from a team's schedule. Use when you need to check the status or details of a time off request.
Get user chatTool 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 TeamworkTool to get userTeamwork settings for a specified user, including Microsoft Teams region and locale. Use when you need to determine user's Teams configuration or regional settings.
List user's associated teamsTool to list teams that a user is associated with in Microsoft Teams. Use when you need to get teams where a user is either a direct member or a member of a shared channel hosted in the team.
List channel message changesSynchronize messages created, updated, or deleted in one Microsoft Teams channel and return an opaque continuation cursor.
List channel tabsTool to list tabs from a Microsoft Teams channel. Use when you need to retrieve all tabs configured in a specific channel. Note: The Files tab (native to channels) is not returned by this API.
List deleted teamsTool to list deleted Microsoft Teams and their properties. Use when you need to retrieve a list of teams that have been deleted.
List directory role membersList principals assigned to a Microsoft Entra directory role.
List group application role assignmentsList application roles granted to a Microsoft Entra group.
List group calendar eventsList events from a Microsoft 365 group's calendar with OData filtering, ordering, selection, and pagination.
List group membersList direct directory members of a Microsoft 365 group with optional selected fields.
List team incoming channelsTool to list incoming channels shared with a Microsoft Teams team. Use when you need to view channels from other teams that have been shared with this team.
List installed apps in teamTool 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 channel message repliesTool to list all replies to a specific message in a Microsoft Teams channel. Use when you need to retrieve the conversation thread for a particular message.
List messages to yourselfList one page from your Microsoft Teams self-DM (the chat with yourself), so you can read personal notes without looking up any chat or user ID.
List my Planner plansList one page of Planner plans shared with the signed-in user.
List my Planner tasksList one page of Planner tasks assigned to the signed-in user.
List offer shift requestsTool to list offer shift requests in a Microsoft Teams schedule. Use when you need to retrieve all offer shift requests for a team's schedule.
List user online meetingsLook up a Microsoft Teams online meeting for a user by identifier. This is effectively a 'lookup-by-identifier' endpoint, NOT a general-purpose list or search. Microsoft Graph REQUIRES an OData $filte
List open shift change requestsTool to list open shift change requests in a Microsoft Teams schedule. Use when you need to retrieve all open shift requests for a team's schedule.
List open shiftsTool 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 organizationsRead Microsoft 365 tenant organization metadata, including display names and verified domains. Microsoft Graph normally returns one organization.
List PeopleRetrieves 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 messagesTool to retrieve the list of pinned messages in a Microsoft Teams chat. Use when you need to get all messages that have been pinned in a specific chat conversation.
List Planner plan tasksList one page of tasks belonging to a Microsoft Planner plan.
List team schedule day notesTool 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 groupsTool to list scheduling groups in a team's schedule. Use when you need to retrieve all scheduling groups for shift management and organization.
List shiftsTool to list shifts in a Microsoft Teams schedule. Use when you need to retrieve all shifts for a team's schedule.
List Graph subscriptionsList Microsoft Graph change-notification subscriptions visible to the connected application and user.
List swap shifts change requestsTool to list swap shift change requests in a Microsoft Teams schedule. Use when you need to retrieve all swap shift requests for a team's schedule.
List teams permission grantsTool to list all resource-specific permission grants for a team with support for filtering, pagination, and sorting. Use when you need to identify which Microsoft Entra apps have access to a team and
List team tagsList tags configured in a Microsoft Teams team.
List team time off entriesTool to list time off entries from a Microsoft Teams team's schedule. Use when you need to retrieve all time off periods for a team.
List team schedule time off reasonsTool 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 requestsTool to retrieve a list of time off requests from a Microsoft Teams team's schedule. Use when you need to view all time off requests including their status (pending, approved, declined), dates, and as
List user chat messagesTool to retrieve messages from a specific chat for a given user. Use when you need to access chat messages through the user context.
List user joined teamsTool 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 usersTool to list all users in the organization. Use when you need to retrieve directory users with filtering, pagination, and field selection.
List TeamsRetrieves Microsoft Teams accessible by the authenticated user, allowing filtering, property selection, and pagination.
List team channelsRetrieves 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.

Held for approval by default (changes and sends)

Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 93 actions.

Add chat memberTool to add a conversationMember to a Microsoft Teams chat. Use when adding a user to an existing chat conversation.
Add member to channelTool 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 you need to add an owner to manage the channel.
Add member to teamTool 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. Use when adding several users at once to improve efficiency.
Archive channelTool to archive a channel in a Microsoft Teams team. Use when you need to archive a specific channel within a team.
Archive team channelTool to archive a channel in a Microsoft Teams team using the group ID. Use when you need to archive a specific channel within a team.
Archive Teams teamTool to archive a Microsoft Teams team. Use after confirming the team ID; returns 202 if accepted.
Clone TeamTool 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. This is an asynchronous operation; poll the
Create Call OperationTool to create a new operation for a communications call. Use when you need to initiate a new operation on an active call.
Create online meetingUse to schedule a new standalone Microsoft Teams online meeting, i.e., one not linked to any calendar event.
Create open shiftsTool to create a new open shift in a Microsoft Teams team schedule. Use when you need to publish available shifts that team members can claim.
Create team schedule shiftTool to create a new shift in a Microsoft Teams team schedule. Use when you need to assign work shifts to team members with specific start/end times and details.

Show all 93

Create TeamTool to create a new Microsoft Teams team. Use when you need to provision a team with optional template, channels, and members.
Create Team From GroupTool to create a new team under an existing Microsoft 365 group. Use when you need to add Teams capabilities to an existing group.
Create time offTool 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 reasonTool 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 team channelTool to delete a channel from a Microsoft Teams team. Use when you need to permanently remove a channel. Note that the General channel cannot be deleted.
Delete team schedule day noteTool 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. The If-Match header with ETag value is required for deletio
Delete open shiftTool to delete an open shift from a Microsoft Teams schedule. Use when you need to remove an unfilled shift from the team schedule.
Delete team scheduling groupTool to delete a scheduling group from a Microsoft Teams team schedule. Use this when you need to remove a scheduling group from a specific team.
Delete team schedule shiftTool to delete a shift from a Microsoft Teams team schedule. Use when you need to permanently remove a scheduled shift.
Soft-delete Teams channel messageTool to soft-delete a message in a Teams channel. Use when you need to remove a message without permanently deleting it.
Delete channel tabTool to delete a tab from a Microsoft Teams channel. Use when you need to permanently remove a tab from a channel.
Delete Teams teamTool to delete a Microsoft Teams team. Use after confirming the target team ID.
Delete time offTool 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 reasonTool to delete a time off reason from a team's schedule. Use when you need to remove a time off reason. Note: This operation marks the time off reason as inactive rather than permanently deleting it.
Delete time off requestTool to delete a time off request from a Microsoft Teams team schedule. Use when you need to permanently remove a time off request.
Delete User Online MeetingTool to delete an online meeting for a user. Use when you need to permanently remove an online meeting from a user's calendar.
Remove channel email addressTool to remove the email address of a channel in Microsoft Teams. Use when you need to disable email integration for a specific channel.
Remove chat memberTool to remove a member from a Microsoft Teams chat. Use when you need to remove a user from a chat conversation.
Remove team memberTool to remove a member from a Microsoft Teams team. Use when you need to remove a user from a team.
Remove team membersTool to remove multiple members from a Microsoft Teams team in bulk. Use when you need to remove one or more users from a team.
Set PresenceTool to set the presence information for a user's application presence session. Use when you need to update a user's presence state in Microsoft Teams. Valid combinations: Available/Available, Busy/In
Set User Preferred PresenceTool to set the preferred availability and activity status for a user. Use when you need to update a user's presence status in Microsoft Teams. Preferred presence takes effect only when at least one p
Create ChatCreates 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 in
Unarchive channelTool to unarchive a channel in a Microsoft Teams team. Use when you need to restore an archived channel to active state.
Unarchive group team channelTool to unarchive a channel in a Microsoft Teams group's team. Use when you need to restore an archived channel to active state.
Unarchive Teams teamTool to unarchive a Microsoft Teams team. Use when you need to restore an archived team to active state.
Unpin chat messageTool to unpin a message from a Microsoft Teams chat. Use when you need to remove a pinned message.
Update Call OperationTool to update the navigation property operations in communications. Use when you need to modify properties of an existing call operation.
Update Teams channelTool to update channel properties in a Microsoft Teams group. Use when you need to modify channel description, display name, or favorite settings.
Update Teams channel messageTool to update a message in a channel. Use when you need to modify an existing channel message after confirming channel and message IDs.
Update ChatTool to update the properties of a chat. Use when you need to modify chat settings such as the topic.
Update Teams chat messageTool to update a specific message in a chat. Use when you need to correct or modify a sent chat message.
Update open shiftTool to update an existing open shift in a Microsoft Teams team schedule. Use when you need to modify open shift details such as times, theme, notes, or open slot count.
Update Teams channel tabTool to update the properties of a tab in a Microsoft Teams channel. Use when you need to modify tab display name, configuration, or web URL.
Update TeamTool to update the properties of a team. Use when you need to modify team settings such as member, messaging, or fun settings.
Update team memberTool to update a team member's roles or properties in Microsoft Teams. Use when you need to change a member's role (e.g., promote to owner or demote to member).
Update team schedule shiftTool to update an existing shift in a Microsoft Teams team schedule. Use when you need to modify shift details like times, assigned user, or notes.
Update time offTool to replace an existing timeOff entry in a team's schedule. Use when you need to update time off details including dates, reason, or status.
Update time off reasonTool 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.
Add tab to channelTool 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.
Clear Automatic LocationTool to clear the automatic location from a user's presence in Microsoft Teams. Use when you need to remove automatically-set location information from presence status.
Clear User Preferred PresenceTool to clear a user's preferred presence setting in Microsoft Teams. Use when you need to remove the user's manually set presence status and allow the system to automatically determine their presence
Clear PresenceTool to clear the presence information for a user's application presence session in Microsoft Teams. Use when you need to remove presence information set by an application for the authenticated user.
Clear Presence LocationTool to clear the authenticated user's presence location. Use when you need to remove location information from the user's current presence status.
Create a channelTool to create a new standard, private, or shared channel within a Microsoft Teams team. Use when you need to create a new channel for team collaboration.
Create Content Sharing SessionTool to create a content sharing session in a Microsoft Teams call. Use when you need to initiate content sharing during an active call.
Create channel in group teamTool 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 user offer shift requestTool to create a new offer shift request in a user's joined team schedule. Use when a team member wants to offer their shift to another team member.
Create open shift change requestTool to create a new open shift change request in a team schedule. Use when a team member wants to claim an available open shift.
Create or get online meetingTool to create a new Microsoft Teams online meeting or retrieve an existing one based on externalId. Use when you need an idempotent meeting creation operation that returns an existing meeting if the
Create or update scheduleTool to create or replace a schedule object for a Microsoft Teams team. Use when you need to enable or configure scheduling features for a team.
Create schedule day noteTool 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. Day notes help communicate important information to team membe
Create scheduling groupTool 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. This action uses 'team_id' parameter naming whic
Create Graph subscriptionCreate a Microsoft Graph change-notification subscription for a Teams resource. The connected account must have the read permission required by the selected resource.
Create time off requestTool 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 meetingTool to create a new Microsoft Teams online meeting for a specific user. Use when you need to create an online meeting on behalf of a user.
Delete Call OperationTool to delete a navigation property operation for a communications call. Use when you need to remove a specific commsOperation from a call.
Delete Planner taskPermanently delete a Microsoft Planner task using its last known ETag. Microsoft Graph rejects the deletion if the task has changed since that ETag was read.
Delete Graph subscriptionPermanently delete a Microsoft Graph change-notification subscription by ID. The connected account must retain the permission used for the subscribed Teams resource.
Get channel message replyTool to retrieve a single reply to a message in a channel. Use when you need to get details of a specific reply message.
Hide chat for userTool to hide a Microsoft Teams chat for a specific user. Use when you need to hide a chat from a user's chat list. Note: The chat is automatically unhidden if an action such as sending a message is ta
Mark chat as read for userTool to mark a chat as read for a specific user in Microsoft Teams. Use when you need to update the read status of a chat for a particular user.
Mark chat as unread for userMarks a specific chat as unread for a user by setting the last read message timestamp. Use when you need to mark messages after a certain time as unread.
Pin message in chatTool to pin a message in a Microsoft Teams chat. Use when you need to highlight an important message for quick access.
Reply to Teams channel messageSends 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 addressTool to provision an email address for a Microsoft Teams channel. Use when you need to enable email integration for a specific channel.
Send Activity Notification to RecipientsTool to send activity notifications to specified recipients in Microsoft Teams. Use when you need to send custom notifications to users, team members, or channel members.
Send a message to yourselfSend a message to your Microsoft Teams self-DM (the chat with yourself), useful for saving a personal note without looking up any chat or user ID.
Set Presence Automatic LocationTool to set the automatic presence location (office/remote/timeOff) for a specified user. Use when updating work location status in Microsoft Teams via automatic detection.
Set User Presence Manual LocationTool to set the manual presence location (office/remote/timeOff) for a specific user. Use when updating work location status for a user in Microsoft Teams.
Share Team ScheduleTool to share a Microsoft Teams schedule for a specified time range. Use when you need to make a team's schedule visible to members.
Send Channel MessagePosts a new top-level message to a channel in Microsoft Teams (does NOT reply to an existing message). Despite the file name 'reply_to_channel_chat', this action creates a brand-new message in the cha
Send message to Teams chatSends a non-empty message (text or HTML) to a specified, existing Microsoft Teams chat; content must be valid HTML if `content_type` is 'html'.
Unhide Chat For UserTool 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.
Update CallTool to update the navigation property calls in Microsoft Teams communications. Use when you need to modify properties of an existing call.
Update Call ParticipantTool to update a participant in a Microsoft Teams call. Use when you need to modify participant properties such as lobby status.
Update Content Sharing SessionTool to update a content sharing session in a Microsoft Teams call. Use when you need to modify the properties of an existing content sharing session.
Update schedule day noteTool 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 meetingTool to update the properties of an existing Microsoft Teams online meeting. Use when you need to modify meeting details such as subject, start time, or end time.
Update scheduling groupTool to replace/update a scheduling group in a team's schedule. Use when you need to modify properties of an existing scheduling group such as display name, active status, code, or member list.
Renew Graph subscriptionRenew a Microsoft Graph subscription or replace its notification URL.

Changes wait in Needs you

Changes and sends in Microsoft Teams are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.

How approvals work

Microsoft Teams questions

Can an agent change data in Microsoft Teams on its own?

Not by default. Changes and sends in Microsoft Teams are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.

What can an agent read in Microsoft Teams?

This connector lists 81 read actions. Reads run at once, without waiting for approval.

How does Microsoft Teams connect?

It connects with OAuth 2.0 or Server-to-server OAuth. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.

Bring Microsoft Teams to your agents.

Book a discovery call