Microsoft Teams

Connect to Microsoft Teams for team/channel management, messaging, chatting, user search, and other communication features.

Key Features

• List joined teams and channels
• Send and retrieve channel messages
• Manage 1:1 and group chats
• Search messages (KQL query support)
• Create and retrieve thread replies
• Search team members and users
• HTML formatting and @mentions support
• Create new chats

Basic Information

Authentication Method

Authenticates using OAuth 2.0.

Supported MCP Tools

API Request Tool

request

A general-purpose tool to make direct requests to the Microsoft Teams Graph API.

Team Management Tools

list-joined-teams

List all Microsoft Teams that the user has joined. Returns team names, descriptions, and IDs.

list-channels

List all channels in a specific Microsoft Team.

Input Parameters:

• team-id (required): Team ID

list-team-members

List all members of a Microsoft Team.

Input Parameters:

• team-id (required): Team ID

Channel Message Tools

get-channel-messages

Get recent messages from a Teams channel.

send-channel-message

Send a message to a Teams channel. Supports text, HTML formatting, and @mentions.

Input Parameters:

• team-id (required): Team ID
• channel-id (required): Channel ID
• content (required): Message content
• contentType (optional): Content type (text/html)
• userMentions (optional): User mentions list
• channelMentions (optional): Channel mentions list

send-thread-reply

Reply to a specific message thread in a Teams channel.

Input Parameters:

• team-id (required): Team ID
• channel-id (required): Channel ID
• message-id (required): Message ID
• content (required): Reply content
• contentType (optional): Content type (text/html)
• userMentions (optional): User mentions list

get-thread-replies

Get all replies to a specific message thread in a Teams channel.

Input Parameters:

• team-id (required): Team ID
• channel-id (required): Channel ID
• message-id (required): Message ID

Chat Tools

list-chats

List all 1:1 and group chats the user participates in.

get-chat-messages

Get recent messages from a specific chat.

Input Parameters:

• chat-id (required): Chat ID

send-chat-message

Send a message to a chat (1:1 or group). Supports text, HTML formatting, and @mentions.

Input Parameters:

• chat-id (required): Chat ID
• content (required): Message content
• contentType (optional): Content type (text/html)
• userMentions (optional): User mentions list

create-chat

Create a new 1:1 or group chat with specified users.

Input Parameters:

• members (required): List of users to include in the chat

Search Tools

search-messages

Search messages across Teams using Microsoft Search API with KQL query syntax.

Input Parameters:

• query (required): KQL search query

search-users

Search for users in the organization by name or email.

Input Parameters:

• query (required): Search query

Usage Example

For example,

• If you input a prompt like “Send ‘Deployment completed’ message to the ‘Development Team’ channel in Teams”,
• The LLM calls the send-channel-message tool via MCP to send the message.
• Then, it responds in the chat based on the tool call result.