Skip to main content

Microsoft Teams

Comprehensive Microsoft Teams connector for managing teams, channels, messages, members, and file operations through Microsoft Graph API v1.0.

📝 Note: This connector gives agents access to Teams data. To chat with your agents inside Teams, see Microsoft Teams integration.

What you can ask​

  • Summarize messages in the Engineering Standup channel from the last 24 hours.
  • Post the release notes to the Releases channel after every deploy.
  • Find every channel I'm in that's had no activity in the last 90 days.

Set up​

Microsoft Teams needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.

  1. Go to Organization > Connectors and find Microsoft Teams. Click Enable, and choose which tools to allow.
  2. Create an OAuth application in the Microsoft Entra admin center.
  3. Add the Redirect URI shown in the connector settings to the application.
  4. Copy the application's Client ID and Client Secret into the connector, then save it.
  5. Each member connects their own account the first time they use it.

⚠️ Warning: Do not enter your Devs.ai or Microsoft Teams login email or password in the OAuth application fields.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

OAuth scopes used by these tools (28)

Grant the scopes for the tools you plan to allow.

  • Calendars.Read
  • Calendars.ReadWrite
  • Channel.Create
  • Channel.Delete.All
  • Channel.ReadBasic.All
  • ChannelMember.Read.All
  • ChannelMember.ReadWrite.All
  • ChannelMessage.Read.All
  • ChannelMessage.ReadWrite
  • ChannelMessage.Send
  • ChannelSettings.ReadWrite.All
  • Chat.Create
  • Chat.Read
  • Chat.ReadBasic
  • ChatMessage.Send
  • Files.Read.All
  • Files.ReadWrite.All
  • Group.ReadWrite.All
  • OnlineMeetingTranscript.Read.All
  • OnlineMeetings.Read
  • Presence.Read.All
  • Team.Create
  • Team.ReadBasic.All
  • TeamMember.Read.All
  • TeamMember.ReadWrite.All
  • TeamSettings.ReadWrite.All
  • User.Read
  • User.ReadBasic.All

Tools​

Microsoft Teams offers 50 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (30)​

View and search information without changing it.

ToolWhat it does
check_channel_typeCheck if a channel is private or standard.
check_user_availabilityCheck if a user is likely available by looking at their recent activity and profile information.
get_channel_infoGet detailed information about a Teams channel including description, settings, and metadata.
get_channel_messageGet detailed information about a specific message including sender, timestamp, and full content.
get_free_busy_scheduleCheck availability and free/busy times for users to find meeting time slots.
get_meeting_detailsGet detailed information about a specific meeting including attendees, Teams link, and agenda.
get_message_repliesRetrieve the replies to a channel message to read a whole thread.
get_team_infoGet detailed information about a specific Microsoft Team including settings, member count, and metadata.
get_team_memberGet detailed information about a specific team member including their role, permissions, and profile.
get_team_primary_channelGet information about a Team's default 'General' channel where main discussions occur.
get_transcript_contentGet transcript content in VTT format with speaker names and timestamps.
get_user_infoGet detailed information about a specific user including profile, contact info, and organizational details.
get_user_presenceGet a user's presence status (available, busy, away, offline).
list_all_my_messagesGet messages from Teams channels and DMs.
list_channel_membersList all members with access to a specific channel, especially useful for private channels.
list_channel_messagesRetrieve message history from a Teams channel; each message carries an is_from_me flag.
list_channelsList all channels in a Microsoft Team.
list_direct_chatsList all direct chats and group chats the user is part of.
list_meeting_transcriptsList available transcripts for a meeting with metadata (IDs, timestamps, URLs).
list_meetingsList upcoming meetings and calendar events for the current user.
list_private_channelsList only the private channels in a team.
list_team_filesList items in a team's SharePoint drive.
list_team_membersList all members of a Microsoft Team with their roles and status.
list_teamsList all Microsoft Teams that the user is a member of.
read_direct_chat_messagesRead messages from a specific direct chat or group chat.
read_team_file_textRead a file in a team's drive as text, by drive_id and item_id from list_team_files.
search_messagesSearch Teams messages by keyword, optionally narrowed to a team (list_teams), a channel (list_channels), a sender and a created_after/created_before window, in one call.
search_teamsSearch for Teams by name or description to quickly find relevant workspaces.
search_usersSearch for users in the organization by name, email, or display name.
validate_credentialValidate Microsoft Teams credentials.

Write (9)​

Create or send data.

ToolWhat it does
add_channel_memberAdd a user to a private channel for selective access control.
add_message_reactionAdd an emoji reaction to a message in a Teams channel.
add_team_memberAdd a new member to a Microsoft Team with specified roles and permissions.
create_channelCreate a new channel within a Team for focused discussions.
create_meetingCreate a new Teams meeting with attendees and schedule it in calendars.
create_teamCreate a new Microsoft Team for collaboration.
reply_to_messageReply to a specific message in a Teams channel to create threaded conversations.
send_channel_messageSend a message to a Teams channel.
send_chat_messageSend a message to a 1:1 or group chat outside of channels.

Delete or overwrite (11)​

Remove or replace existing data.

ToolWhat it does
cancel_meetingCancel a scheduled meeting and notify all attendees.
delete_channelPermanently delete a channel from a Team.
delete_teamPermanently delete a Microsoft Team.
delete_team_fileRemove files from a Team's drive to clean up outdated content, free up storage, or remove sensitive information.
remove_channel_memberRemove a user from a private channel while maintaining their team membership.
remove_team_memberRemove a member from a Microsoft Team to revoke their access to team resources.
update_channelUpdate channel settings such as name, description, or moderation settings.
update_channel_messageEdit or update a previously sent message in a Teams channel.
update_meetingUpdate an existing meeting's details such as time, attendees, or description.
update_teamUpdate team properties and settings including display name, description, member permissions, guest settings, messaging options, and fun features.
update_team_memberUpdate a team member's role or permissions within the team.
⌘J