Microsoft Teams
How to configure the Microsoft Teams MCP connector
The Microsoft Teams connector allows the chatbot to interact with Microsoft Teams channels, chats, and messages through Microsoft Graph API using the ms-365-mcp-server.
Connector Settings
| Field | Value |
|---|---|
| Integration Type | MCP |
| Name | Microsoft Teams |
| URL | https://ms365-teams.mcp.mitigate.dev/mcp |
| Transport Type | Streamable HTTP |
| Authentication Type | OAuth 2.1 |
| OAuth Scopes | openid profile offline_access Team.ReadBasic.All Channel.ReadBasic.All ChannelMessage.Read.All ChannelMessage.Send TeamMember.Read.All Chat.Read ChatMessage.Read ChatMessage.Send |
This MCP server supports Dynamic Client Registration (RFC 7591) — OAuth Client ID and Client Secret are not required.
A tenant admin must grant admin consent for the Mitigate AI Platform application before users can connect.
Application ID: bc2b3dde-4f74-483d-93c0-919c4b804b48
Use this direct link to grant consent: Grant admin consent
Or follow the manual steps:
- Sign in to the Microsoft Entra admin center as at least a Cloud Application Administrator.
- Browse to Identity → Applications → Enterprise applications → All applications.
- Search for Mitigate AI Platform and select it.
- Select Permissions under Security.
- Review the permissions and select Grant admin consent.
OAuth Scopes
See all available scopes in the Microsoft Graph permissions reference.
| Scope | Description |
|---|---|
openid | Enables OpenID Connect sign-in |
profile | Access to the user's basic profile information |
offline_access | Allows token refresh without re-prompting the user |
Team.ReadBasic.All | Read the names and descriptions of teams the user is a member of |
Channel.ReadBasic.All | Read channel names and descriptions on behalf of the signed-in user |
ChannelMessage.Read.All | Read messages in Teams channels on behalf of the signed-in user |
ChannelMessage.Send | Send messages in Teams channels on behalf of the signed-in user |
TeamMember.Read.All | Read the members of Teams on behalf of the signed-in user |
Chat.Read | Read the user's 1:1 and group chat messages |
ChatMessage.Read | Read messages in 1:1 and group chats on behalf of the signed-in user |
ChatMessage.Send | Send messages in 1:1 and group chats on behalf of the signed-in user |
Usage Examples
Once connected, users can interact with Microsoft Teams through natural language:
- "List my Teams channels"
- "What are the latest messages in the General channel?"
- "Send a message to the Engineering team channel"
- "Show my recent chat conversations"
- "Reply to the last message in the project channel"
Tools
Get Team
get-team
Retrieve the properties and relationships of the specified team.
Parameters:
- teamId - The ID of the team
List Joined Teams
list-joined-teams
Get the teams in Microsoft Teams that the user is a direct member of.
List Team Channels
list-team-channels
Retrieve the list of channels in a team.
Parameters:
- teamId - The ID of the team
Get Team Channel
get-team-channel
Retrieve the properties and relationships of a channel. Only a user who is a member of the shared channel can retrieve channel information.
Parameters:
- teamId - The ID of the team
- channelId - The ID of the channel
List Channel Messages
list-channel-messages
Retrieve the list of messages (without replies) in a channel of a team. To get replies for a message, use the list channel message replies tool.
Parameters:
- teamId - The ID of the team
- channelId - The ID of the channel
Send Channel Message
send-channel-message
Send a new message in the specified channel.
Parameters:
- teamId - The ID of the team
- channelId - The ID of the channel
- body - The message content to send
Get Channel Message
get-channel-message
Retrieve a single message in a channel.
Parameters:
- teamId - The ID of the team
- channelId - The ID of the channel
- chatMessageId - The ID of the message
List Channel Message Replies
list-channel-message-replies
List all the replies to a message in a channel of a team.
Parameters:
- teamId - The ID of the team
- channelId - The ID of the channel
- chatMessageId - The ID of the message
Reply To Channel Message
reply-to-channel-message
Create a new reply to a message in a specified channel.
Parameters:
- teamId - The ID of the team
- channelId - The ID of the channel
- chatMessageId - The ID of the message to reply to
- body - The reply content to send
List Team Members
list-team-members
Get the members of a team.
Parameters:
- teamId - The ID of the team
List Chats
list-chats
Get the user's 1:1 and group chats.
Get Chat
get-chat
Retrieve a single chat (without its messages).
Parameters:
- chatId - The ID of the chat
List Chat Messages
list-chat-messages
Retrieve the list of messages in a chat.
Parameters:
- chatId - The ID of the chat
Send Chat Message
send-chat-message
Send a new message in the specified chat. This API can't create a new chat; use the list chats tool to retrieve the ID of an existing chat first.
Parameters:
- chatId - The ID of the chat
- body - The message content to send
Get Chat Message
get-chat-message
Retrieve a single message in a chat.
Parameters:
- chatId - The ID of the chat
- chatMessageId - The ID of the message
List Chat Message Replies
list-chat-message-replies
List all the replies to a message in a chat.
Parameters:
- chatId - The ID of the chat
- chatMessageId - The ID of the message
Reply To Chat Message
reply-to-chat-message
Create a new reply to a message in a chat.
Parameters:
- chatId - The ID of the chat
- chatMessageId - The ID of the message to reply to
- body - The reply content to send