# Microsoft Teams

The Microsoft Graph Teams API enables access to Microsoft Teams data including teams, channels, messages, and team settings. This integration allows managing Teams content and collaboration on behalf of the user.

- Category: Communication
- Connection: Sign in. Sign in with your Microsoft Teams account. No API key to copy.
- Plans: Free: Not included; MCP only ($9/mo): 2,000 calls a month; Pro: 20,000 calls a month; Max: 20,000 calls a month
- Status: coming soon

## Tools

- List channel messages (`MICROSOFT_TEAMS__LIST_CHANNEL_MESSAGES`): Get the list of messages in a channel. This allows you to retrieve conversation messages from a specific team channel.
- List chat members (`MICROSOFT_TEAMS__LIST_CHAT_MEMBERS`): List all members of a chat conversation. This shows who is participating in the chat.
- List chat messages (`MICROSOFT_TEAMS__LIST_CHAT_MESSAGES`): Get all messages in a specific chat. This allows viewing the conversation history in direct messages or group chats.
- List joined teams (`MICROSOFT_TEAMS__LIST_JOINED_TEAMS`): Get the teams in Microsoft Teams that the user is a direct member of. This API doesn't return the host team of the shared channel that the user is a direct member of.
- List message replies (`MICROSOFT_TEAMS__LIST_MESSAGE_REPLIES`): List all replies to a specific message in a channel. This allows viewing conversation threads and discussions.
- List team channels (`MICROSOFT_TEAMS__LIST_TEAM_CHANNELS`): Get the list of channels in a team. This allows you to see all channels within a specific team.
- List team members (`MICROSOFT_TEAMS__LIST_TEAM_MEMBERS`): Get the members of a team. This returns all users who are part of the specified team.
- List user chats (`MICROSOFT_TEAMS__LIST_USER_CHATS`): Get all chats that the user is part of. This includes one-on-one chats, group chats, and meeting chats.
- Update channel (`MICROSOFT_TEAMS__UPDATE_CHANNEL`): Update the properties of a channel such as display name, description, or member settings.
- Update channel message (`MICROSOFT_TEAMS__UPDATE_CHANNEL_MESSAGE`): Update an existing message in a team channel. This allows editing the content of previously sent channel messages.
- Update chat message (`MICROSOFT_TEAMS__UPDATE_CHAT_MESSAGE`): Update an existing message in a chat. This allows editing the content of previously sent chat messages.
- Update team (`MICROSOFT_TEAMS__UPDATE_TEAM`): Update the properties of a team such as display name, description, and visibility settings.
- Update team member (`MICROSOFT_TEAMS__UPDATE_TEAM_MEMBER`): Update a team member's role (e.g., promote to owner or demote to member). This allows changing member permissions within a team.
- Create channel (`MICROSOFT_TEAMS__CREATE_CHANNEL`): Create a new channel in a team. This allows creating standard or private channels within an existing team.
- Create chat (`MICROSOFT_TEAMS__CREATE_CHAT`): Create a new chat conversation. This allows starting one-on-one or group chats with specified members.
- Create team (`MICROSOFT_TEAMS__CREATE_TEAM`): Create a new team in Microsoft Teams. This allows creating a team with specified settings including name, description, visibility, and member permissions.
- Get channel (`MICROSOFT_TEAMS__GET_CHANNEL`): Get the properties and relationships of a channel in a team. This provides detailed information about a specific channel.
- Get chat message (`MICROSOFT_TEAMS__GET_CHAT_MESSAGE`): Get a specific message from a chat. This allows retrieving detailed information about a particular chat message.
- Get team (`MICROSOFT_TEAMS__GET_TEAM`): Get the properties and relationships of the specified team. This returns more detailed information about a team than the basic joined teams list.
- Send channel message (`MICROSOFT_TEAMS__SEND_CHANNEL_MESSAGE`): Send a new message to a channel in a team. This allows posting messages to team channels.
- Send chat message (`MICROSOFT_TEAMS__SEND_CHAT_MESSAGE`): Send a direct message to a team member or in a chat. This allows sending private messages between team members.
- Send message reply (`MICROSOFT_TEAMS__SEND_MESSAGE_REPLY`): Send a reply to a message in a channel. This allows responding to existing messages in team channels.
- Soft delete channel message (`MICROSOFT_TEAMS__SOFT_DELETE_CHANNEL_MESSAGE`): Soft delete a message in a channel. This allows safely removing messages with the ability to restore them later.
- Soft delete chat message (`MICROSOFT_TEAMS__SOFT_DELETE_CHAT_MESSAGE`): Soft delete a message in a chat using the correct Microsoft Graph API endpoint. This allows safely removing chat messages with the ability to restore them later.
- Soft delete reply message (`MICROSOFT_TEAMS__SOFT_DELETE_REPLY_MESSAGE`): Soft delete a reply message in a channel thread. This allows safely removing reply messages with the ability to restore them later.
- Undo soft delete channel message (`MICROSOFT_TEAMS__UNDO_SOFT_DELETE_CHANNEL_MESSAGE`): Undo soft deletion of a message in a channel. This restores a previously soft-deleted message.
- Undo soft delete chat message (`MICROSOFT_TEAMS__UNDO_SOFT_DELETE_CHAT_MESSAGE`): Undo soft deletion of a message in a chat using the correct Microsoft Graph API endpoint. This restores a previously soft-deleted chat message.
- Undo soft delete reply message (`MICROSOFT_TEAMS__UNDO_SOFT_DELETE_REPLY_MESSAGE`): Undo soft deletion of a reply message in a channel thread. This restores a previously soft-deleted reply message.
- Add chat member (`MICROSOFT_TEAMS__ADD_CHAT_MEMBER`): Add a member to a group chat. This allows adding new participants to existing chat conversations.
- Add team member (`MICROSOFT_TEAMS__ADD_TEAM_MEMBER`): Add a member to a team. This allows adding users to an existing team with specified roles.
- Delete channel (`MICROSOFT_TEAMS__DELETE_CHANNEL`): Delete a channel from a team. Note: This cannot be used to delete the General channel.
- Delete team (`MICROSOFT_TEAMS__DELETE_TEAM`): Delete a team and its underlying Microsoft 365 group. This permanently removes the team and all its data.
- Remove chat member (`MICROSOFT_TEAMS__REMOVE_CHAT_MEMBER`): Remove a member from a group chat. This allows removing participants from chat conversations.
- Remove team member (`MICROSOFT_TEAMS__REMOVE_TEAM_MEMBER`): Remove a member from a team. This allows removing users from team membership.
- Set channel message reaction (`MICROSOFT_TEAMS__SET_CHANNEL_MESSAGE_REACTION`): Add a reaction (emoji) to a channel message. This allows users to react to messages with emojis.
- Set chat message reaction (`MICROSOFT_TEAMS__SET_CHAT_MESSAGE_REACTION`): Add a reaction (emoji) to a chat message. This allows users to react to messages with emojis.
- Unset channel message reaction (`MICROSOFT_TEAMS__UNSET_CHANNEL_MESSAGE_REACTION`): Remove a reaction (emoji) from a channel message. This allows users to remove their emoji reactions.
- Unset chat message reaction (`MICROSOFT_TEAMS__UNSET_CHAT_MESSAGE_REACTION`): Remove a reaction (emoji) from a chat message. This allows users to remove their emoji reactions.
- Archive team (`MICROSOFT_TEAMS__ARCHIVE_TEAM`): Archive a team. Archived teams are read-only and members cannot add new content, but existing content remains accessible.
- Unarchive team (`MICROSOFT_TEAMS__UNARCHIVE_TEAM`): Unarchive a team. This restores the team to an active state where members can add new content.

## Questions

### When can I connect Microsoft Teams?

Microsoft Teams is coming soon and cannot be connected yet. Browse the catalog for apps you can connect now.

### Which plan includes Microsoft Teams?

MCP only with 2,000 calls a month, Pro and Max with 20,000. Calls are shared by every catalog app in the workspace. Past the monthly number they keep working from AI credits at $0.90 per 1,000 calls; the count resets on the 1st (UTC) and a retried call counts once.

Back to the [MCP catalog](https://krypton.bot/mcp-catalog/).
