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 Standupchannel from the last 24 hours. - Post the release notes to the
Releaseschannel 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.
- Go to Organization > Connectors and find Microsoft Teams. Click Enable, and choose which tools to allow.
- Create an OAuth application in the Microsoft Entra admin center.
- Add the Redirect URI shown in the connector settings to the application.
- Copy the application's Client ID and Client Secret into the connector, then save it.
- 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.ReadCalendars.ReadWriteChannel.CreateChannel.Delete.AllChannel.ReadBasic.AllChannelMember.Read.AllChannelMember.ReadWrite.AllChannelMessage.Read.AllChannelMessage.ReadWriteChannelMessage.SendChannelSettings.ReadWrite.AllChat.CreateChat.ReadChat.ReadBasicChatMessage.SendFiles.Read.AllFiles.ReadWrite.AllGroup.ReadWrite.AllOnlineMeetingTranscript.Read.AllOnlineMeetings.ReadPresence.Read.AllTeam.CreateTeam.ReadBasic.AllTeamMember.Read.AllTeamMember.ReadWrite.AllTeamSettings.ReadWrite.AllUser.ReadUser.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.
| Tool | What it does |
|---|---|
check_channel_type | Check if a channel is private or standard. |
check_user_availability | Check if a user is likely available by looking at their recent activity and profile information. |
get_channel_info | Get detailed information about a Teams channel including description, settings, and metadata. |
get_channel_message | Get detailed information about a specific message including sender, timestamp, and full content. |
get_free_busy_schedule | Check availability and free/busy times for users to find meeting time slots. |
get_meeting_details | Get detailed information about a specific meeting including attendees, Teams link, and agenda. |
get_message_replies | Retrieve the replies to a channel message to read a whole thread. |
get_team_info | Get detailed information about a specific Microsoft Team including settings, member count, and metadata. |
get_team_member | Get detailed information about a specific team member including their role, permissions, and profile. |
get_team_primary_channel | Get information about a Team's default 'General' channel where main discussions occur. |
get_transcript_content | Get transcript content in VTT format with speaker names and timestamps. |
get_user_info | Get detailed information about a specific user including profile, contact info, and organizational details. |
get_user_presence | Get a user's presence status (available, busy, away, offline). |
list_all_my_messages | Get messages from Teams channels and DMs. |
list_channel_members | List all members with access to a specific channel, especially useful for private channels. |
list_channel_messages | Retrieve message history from a Teams channel; each message carries an is_from_me flag. |
list_channels | List all channels in a Microsoft Team. |
list_direct_chats | List all direct chats and group chats the user is part of. |
list_meeting_transcripts | List available transcripts for a meeting with metadata (IDs, timestamps, URLs). |
list_meetings | List upcoming meetings and calendar events for the current user. |
list_private_channels | List only the private channels in a team. |
list_team_files | List items in a team's SharePoint drive. |
list_team_members | List all members of a Microsoft Team with their roles and status. |
list_teams | List all Microsoft Teams that the user is a member of. |
read_direct_chat_messages | Read messages from a specific direct chat or group chat. |
read_team_file_text | Read a file in a team's drive as text, by drive_id and item_id from list_team_files. |
search_messages | Search 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_teams | Search for Teams by name or description to quickly find relevant workspaces. |
search_users | Search for users in the organization by name, email, or display name. |
validate_credential | Validate Microsoft Teams credentials. |
Write (9)
Create or send data.
| Tool | What it does |
|---|---|
add_channel_member | Add a user to a private channel for selective access control. |
add_message_reaction | Add an emoji reaction to a message in a Teams channel. |
add_team_member | Add a new member to a Microsoft Team with specified roles and permissions. |
create_channel | Create a new channel within a Team for focused discussions. |
create_meeting | Create a new Teams meeting with attendees and schedule it in calendars. |
create_team | Create a new Microsoft Team for collaboration. |
reply_to_message | Reply to a specific message in a Teams channel to create threaded conversations. |
send_channel_message | Send a message to a Teams channel. |
send_chat_message | Send a message to a 1:1 or group chat outside of channels. |
Delete or overwrite (11)
Remove or replace existing data.
| Tool | What it does |
|---|---|
cancel_meeting | Cancel a scheduled meeting and notify all attendees. |
delete_channel | Permanently delete a channel from a Team. |
delete_team | Permanently delete a Microsoft Team. |
delete_team_file | Remove files from a Team's drive to clean up outdated content, free up storage, or remove sensitive information. |
remove_channel_member | Remove a user from a private channel while maintaining their team membership. |
remove_team_member | Remove a member from a Microsoft Team to revoke their access to team resources. |
update_channel | Update channel settings such as name, description, or moderation settings. |
update_channel_message | Edit or update a previously sent message in a Teams channel. |
update_meeting | Update an existing meeting's details such as time, attendees, or description. |
update_team | Update team properties and settings including display name, description, member permissions, guest settings, messaging options, and fun features. |
update_team_member | Update a team member's role or permissions within the team. |