Microsoft 365 Teams

mindstone/mcp-servers

Connects to Microsoft Teams through the Graph API, letting Claude list your chats, read and send messages, browse teams and channels, and check presence status. Built by Mindstone as part of a 35-connector suite, this server shares host-orchestrated OAuth with their other Microsoft 365 connectors (Outlook mail, calendar, OneDrive files, SharePoint). Useful when you need an LLM to search chat history, send updates to team channels, or coordinate notifications based on availability. Ships with stdio transport and follows the same hardened supply-chain practices as the rest of the monorepo, including pinned dependencies, seven-day release cool-down, and provenance attestation on npm.

tools: 30
auth: Required
transport: STDIO
env vars: 5
last updated: Nov 6, 2026

View on GitHub

Tools

30 tools

Public tool metadata for what this MCP can expose to an agent.

MICROSOFT_TEAMS_ADD_MEMBER_TO_TEAMTool to add a user to a Microsoft Teams team. Use when granting or updating membership for a user.3 params

Tool to add a user to a Microsoft Teams team. Use when granting or updating membership for a user.

Parameters* required

rolesarray

Roles to assign to the member. Only 'owner' is supported. Omit or leave empty to add as a standard member.

team_idstring

The unique ID (GUID) of the Microsoft Team to which the member will be added.

user_idstring

The user's Graph ID (GUID) or userPrincipalName (email) to add to the team.

MICROSOFT_TEAMS_ARCHIVE_TEAMTool to archive a Microsoft Teams team. Use after confirming the team ID; returns 202 if accepted.2 params

Tool to archive a Microsoft Teams team. Use after confirming the team ID; returns 202 if accepted.

Parameters* required

should_set_spo_site_read_only_for_membersboolean

If true, sets the SharePoint site to read-only for team members when archiving.default: false

team_idstring

The Microsoft Teams team GUID to archive.

MICROSOFT_TEAMS_CHATS_GET_ALL_CHATSRetrieves all Microsoft Teams chats a specified user is part of, supporting filtering, property selection, and pagination.4 params

Retrieves all Microsoft Teams chats a specified user is part of, supporting filtering, property selection, and pagination.

Parameters* required

filterstring

An OData filter query string to apply to the chat list (e.g., "topic eq 'Project Updates'"). Do not include '$filter=' in the string. This enables retrieving chats that match specific criteria.default:

selectarray

A list of specific Microsoft Graph chat resource properties to retrieve (e.g., 'id', 'topic'). If omitted or empty, a default set of properties is returned. Each string in the list should be a vali...

topinteger

The maximum number of chats to retrieve in a single API call, used for pagination. Default is 50. Microsoft Graph enforces a maximum limit of 50 per request.default: 50

user_idstring

The ID or user principal name (UPN) of the user whose chats are to be retrieved. Use 'me' to specify the currently authenticated user.default: me

MICROSOFT_TEAMS_CHATS_GET_ALL_MESSAGESRetrieves all messages from a specified Microsoft Teams chat using the Microsoft Graph API, automatically handling pagination; ensure `chat_id` is valid and OData expressions in `filter` or `select` are correct.3 params

Retrieves all messages from a specified Microsoft Teams chat using the Microsoft Graph API, automatically handling pagination; ensure `chat_id` is valid and OData expressions in `filter` or `select` are correct.

Parameters* required

chat_idstring

Unique identifier of the Microsoft Teams chat.

filterstring

OData v4.0 filter query string for messages. If empty, no filtering is applied.default:

topinteger

Maximum number of messages to retrieve per page. Used for pagination. Microsoft Graph enforces a maximum limit of 50 per request.default: 50

MICROSOFT_TEAMS_CREATE_MEETINGUse to schedule a new standalone Microsoft Teams online meeting, i.e., one not linked to any calendar event.5 params

Use to schedule a new standalone Microsoft Teams online meeting, i.e., one not linked to any calendar event.

Parameters* required

end_date_timestring

The end date and time of the meeting, specified in ISO 8601 format (e.g., '2024-08-15T11:00:00Z'). Must be after start_date_time.

is_passcode_requiredboolean

An optional boolean indicating whether a passcode should be required to join this meeting. If not specified, the organization's default policy applies.

participantsarray

An optional list of participants to invite to the meeting. Each participant is defined by their user ID and role.

start_date_timestring

The start date and time of the meeting, specified in ISO 8601 format (e.g., '2024-08-15T10:00:00Z').

subjectstring

The subject or title for the online meeting.

MICROSOFT_TEAMS_CREATE_TEAMTool to create a new Microsoft Teams team. Use when you need to provision a team with optional template, channels, and members.6 params

Tool to create a new Microsoft Teams team. Use when you need to provision a team with optional template, channels, and members.

Parameters* required

descriptionstring

Brief description of the team's purpose. Maximum 1024 characters. Note: Known template IDs for team creation: 'standard' (default), 'educationClass', 'educationStaff', 'educationProfessionalLearnin...

displayNamestring

Display name of the team as it will appear in Microsoft Teams. Must be unique within the organization.

firstChannelNamestring

Name of the first channel created; defaults to 'General' if omitted.

membersarray

List of initial team members. At least one member with 'owner' role is recommended. If not provided, the authenticated user will be added as owner. Each member must specify '@odata.type', roles, an...

template_odata_bindstring

URL reference to the team template. Common templates: 'standard' (default), 'educationClass', 'educationStaff', 'educationProfessionalLearningCommunity'. Format: https://graph.microsoft.com/v1.0/te...default: https://graph.microsoft.com/v1.0/teamsTemplates('standard')

visibilitystring

Team visibility setting. 'private': Only owners can add members. 'public': Anyone in the organization can join. Default is 'public'.one of private · publicdefault: public

MICROSOFT_TEAMS_DELETE_TEAMTool to delete a Microsoft Teams team. Use after confirming the target team ID.1 params

Tool to delete a Microsoft Teams team. Use after confirming the target team ID.

Parameters* required

team_idstring

The unique identifier (GUID) of the Microsoft Teams team to delete.

MICROSOFT_TEAMS_GET_CHANNELTool to get a specific channel in a team. Use after obtaining valid team and channel IDs to fetch channel details.2 params

Tool to get a specific channel in a team. Use after obtaining valid team and channel IDs to fetch channel details.

Parameters* required

channel_idstring

The unique identifier of the channel within the specified team.

team_idstring

The unique identifier of the Microsoft Teams team.

MICROSOFT_TEAMS_GET_CHAT_MESSAGETool to get a specific chat message. Use after confirming chat_id and message_id.2 params

Tool to get a specific chat message. Use after confirming chat_id and message_id.

Parameters* required

chat_idstring

Unique identifier of the Microsoft Teams chat that contains the message.

message_idstring

Unique identifier of the chat message to retrieve.

MICROSOFT_TEAMS_GET_TEAMTool to get a specific team. Use when full details of one team by ID are needed.1 params

Tool to get a specific team. Use when full details of one team by ID are needed.

Parameters* required

team_idstring

GUID of the Microsoft Teams team to retrieve.

MICROSOFT_TEAMS_LIST_MESSAGE_REPLIESTool to list replies to a channel message. Use after obtaining team, channel, and message IDs.4 params

Tool to list replies to a channel message. Use after obtaining team, channel, and message IDs.

Parameters* required

channel_idstring

Unique identifier of the channel within the team.

message_idstring

Unique identifier of the channel message whose replies are to be listed.

team_idstring

Unique identifier (GUID) of the Microsoft Teams team.

topinteger

Maximum number of replies to return per page (1-50).default: 50

MICROSOFT_TEAMS_LIST_TEAM_MEMBERSTool to list members of a Microsoft Teams team. Use when you need to retrieve the members of a specific team, for auditing or notifications.2 params

Tool to list members of a Microsoft Teams team. Use when you need to retrieve the members of a specific team, for auditing or notifications.

Parameters* required

team_idstring

GUID of the Microsoft Teams team to retrieve members from.

topinteger

Optional maximum number of members to return (1–999).

MICROSOFT_TEAMS_LIST_TEAMS_TEMPLATESTool to list available Microsoft Teams templates. Use when retrieving templates for team creation or customization workflows.6 params

Tool to list available Microsoft Teams templates. Use when retrieving templates for team creation or customization workflows.

Parameters* required

countboolean

If true, include a count of total matching templates in the response.default: false

filterstring

OData filter expression to filter the templates (e.g., "startsWith(displayName,'Template')").default:

orderbystring

Comma-separated properties and directions to order the results by (e.g., 'displayName desc').default:

selectstring

Comma-separated template properties to include in the response (e.g., 'id,displayName,description'). If empty, default properties are returned.default:

skipinteger

Number of templates to skip for pagination.

topinteger

Maximum number of templates to return (1–999).

MICROSOFT_TEAMS_LIST_USERSTool to list all users in the organization. Use when you need to retrieve directory users with filtering, pagination, and field selection.7 params

Tool to list all users in the organization. Use when you need to retrieve directory users with filtering, pagination, and field selection.

Parameters* required

$expandstring

OData expand related entities (e.g., `manager`).

$filterstring

OData filter to refine results by property values (e.g., `startswith(displayName,'A')`).

$orderbystring

OData orderby clause to sort results (e.g., `displayName desc`).

$selectstring

Comma-separated list of user properties to include (e.g., `id,displayName,mail`).

$skipinteger

Number of users to skip for pagination.

$topinteger

Maximum number of users to return per page (1-999).

consistencyLevelstring

Set to 'eventual' when using advanced queries with $count.

MICROSOFT_TEAMS_SEARCH_FILESSearch files in Microsoft Teams using KQL syntax. Find files by name, type, content, author, and modification date across all Teams and channels. Supports boolean logic and date ranges. Examples: 'filetype:pdf AND lastmodifiedtime>=2024-10-01', 'contract AND budget', 'filename...4 params

Search files in Microsoft Teams using KQL syntax. Find files by name, type, content, author, and modification date across all Teams and channels. Supports boolean logic and date ranges. Examples: 'filetype:pdf AND lastmodifiedtime>=2024-10-01', 'contract AND budget', 'filename...

Parameters* required

enable_top_resultsboolean

If `true`, sorts results by relevance; otherwise, sorts by date modified in descending order (newest first).default: false

from_indexinteger

The 0-based starting index for pagination. To paginate: check response['value'][0]['hitsContainers'][0]['moreResultsAvailable']. If true, call again with from_index += size (e.g., 0 → 25 → 50).default: 0

querystring

Search query for files in Teams. Supports keywords, filenames, and content search. **Basic Syntax:** - Keywords: 'budget contract' - Exact phrases: '"project timeline"' - Filenames: 'report.pdf' o...

sizeinteger

The maximum number of file results to return per page. Use with from_index for pagination.default: 25

MICROSOFT_TEAMS_SEARCH_MESSAGESSearch Microsoft Teams messages using powerful KQL syntax. Supports sender (from:), date filters (sent:), attachments, and boolean logic. Works across all Teams chats and channels the user has access to. Examples: 'from:user@example.com AND sent>=2024-10-01', 'punchlist OR ter...4 params

Search Microsoft Teams messages using powerful KQL syntax. Supports sender (from:), date filters (sent:), attachments, and boolean logic. Works across all Teams chats and channels the user has access to. Examples: 'from:user@example.com AND sent>=2024-10-01', 'punchlist OR ter...

Parameters* required

enable_top_resultsboolean

If `true`, sorts results by relevance; otherwise, sorts by date in descending order (newest first).default: false

from_indexinteger

querystring

KQL (Keyword Query Language) search query string. Supports advanced syntax for precise searches. **Basic Syntax:** - Simple keywords: 'budget report' - Exact phrases: '"quarterly review"' - Boolea...default:

sizeinteger

The maximum number of search results to return per page. Use with from_index for pagination.default: 25

MICROSOFT_TEAMS_TEAMS_CREATE_CHANNELCreates a new 'standard', 'private', or 'shared' channel within a specified Microsoft Teams team.4 params

Creates a new 'standard', 'private', or 'shared' channel within a specified Microsoft Teams team.

Parameters* required

descriptionstring

An optional, user-friendly description of the channel's purpose. Maximum length is 1024 characters.default:

membership_typestring

Membership type determining channel accessibility: 'standard' is accessible to all team members, 'private' is only accessible to a specific subset of team members, and 'shared' can be shared with p...default: standard

namestring

The display name for the new channel. Maximum length is 50 characters. Cannot contain characters ~ # % & * { } + / \ : < > ? | ' " or start with an underscore or period, or end with a period.

team_idstring

The GUID of the existing Microsoft Teams team where the new channel will be created.

MICROSOFT_TEAMS_TEAMS_CREATE_CHATCreates a new chat; if a 'oneOnOne' chat with the specified members already exists, its details are returned, while 'group' chats are always newly created.3 params

Creates a new chat; if a 'oneOnOne' chat with the specified members already exists, its details are returned, while 'group' chats are always newly created.

Parameters* required

chatTypestring

Type of chat. If 'oneOnOne' for members with an existing chat, that chat's details are returned.

membersarray

List of members. For 'oneOnOne' chats, exactly two members are required. For 'group' chats, at least two members are required and at least one member must have the 'owner' role.

topicstring

Subject or title for the chat. REQUIRED for group chats. For 'oneOnOne' chats, this field is ignored and should be omitted.

MICROSOFT_TEAMS_TEAMS_GET_MESSAGERetrieves a specific message from a Microsoft Teams channel using its Team, Channel, and Message IDs.3 params

Retrieves a specific message from a Microsoft Teams channel using its Team, Channel, and Message IDs.

Parameters* required

channel_idstring

ID of the Channel within the specified Team that contains the message.

message_idstring

ID of the message to retrieve from the channel.

team_idstring

ID of the Team containing the channel where the message is located.

MICROSOFT_TEAMS_TEAMS_LISTRetrieves Microsoft Teams accessible by the authenticated user, allowing filtering, property selection, and pagination.3 params

Retrieves Microsoft Teams accessible by the authenticated user, allowing filtering, property selection, and pagination.

Parameters* required

filterstring

OData v4.0 filter string to refine results based on team properties (e.g., `startsWith(displayName,'A')`). Consult OData v4.0 documentation for syntax.default:

selectstring

Comma-separated team properties to retrieve (e.g., 'id,displayName,description'). If empty or omitted, standard properties are returned. Supported properties include `id`, `displayName`, `descripti...default:

topinteger

Maximum number of teams to return per page (1-999). Used for pagination; see `next_link` in response.default: 100

MICROSOFT_TEAMS_TEAMS_LIST_CHANNELSRetrieves channels for a specified Microsoft Teams team ID (must be valid and for an existing team), with options to include shared channels, filter results, and select properties.4 params

Retrieves channels for a specified Microsoft Teams team ID (must be valid and for an existing team), with options to include shared channels, filter results, and select properties.

Parameters* required

filterstring

OData v4 query string to filter channels (e.g., `startswith(displayName,'Sales')` or `membershipType eq 'private'`).default:

include_shared_channelsboolean

If true, include channels shared with the team.default: false

selectstring

Comma-separated channel properties to return (e.g., 'id,displayName,description'); empty for default properties. Common: `id`, `displayName`, `description`, `email`, `membershipType`, `webUrl`.default:

team_idstring

Unique identifier (ID) of the Microsoft Teams team.

MICROSOFT_TEAMS_TEAMS_LIST_CHAT_MESSAGESRetrieves messages (newest first) from an existing and accessible Microsoft Teams one-on-one chat, group chat, or channel thread, specified by `chat_id`.2 params

Retrieves messages (newest first) from an existing and accessible Microsoft Teams one-on-one chat, group chat, or channel thread, specified by `chat_id`.

Parameters* required

chat_idstring

Unique Microsoft Graph chat identifier (GUID format). This is the chat ID returned by Graph API, not a channel thread ID. Use the Get All Chats action to retrieve valid chat IDs.

topinteger

Maximum number of messages to retrieve. Microsoft Graph enforces a maximum limit of 50 per request.default: 50

MICROSOFT_TEAMS_TEAMS_LIST_PEOPLERetrieves a list of people relevant to a specified user from Microsoft Graph, noting the `search` parameter is only effective if `user_id` is 'me'.7 params

Retrieves a list of people relevant to a specified user from Microsoft Graph, noting the `search` parameter is only effective if `user_id` is 'me'.

Parameters* required

filterstring

OData $filter query to limit results (e.g., `"startsWith(displayName,'A')"`).

orderbystring

OData $orderby expression to sort results (e.g., 'displayName asc, relevanceScore desc').

searchstring

Fuzzy search query (name, email, or topic like 'topic:marketing'). Effective only when `user_id` is 'me'.

selectstring

Comma-separated OData property names to include for each person (e.g., 'id,displayName'). If unspecified, a default set is returned. Note: 'emailAddresses' is not a valid property for microsoft.gra...

skipinteger

Number of items to skip for pagination.

topinteger

Maximum number of items per page for pagination. Actual count may be less. Service default if unspecified.

user_idstring

Identifier of the user (e.g., 'me', 'adelev@contoso.com', or GUID) whose relevant people are to be retrieved.default: me

MICROSOFT_TEAMS_TEAMS_POST_CHANNEL_MESSAGEPosts a new text or HTML message to a specified channel in a Microsoft Teams team.4 params

Posts a new text or HTML message to a specified channel in a Microsoft Teams team.

Parameters* required

channel_idstring

The unique identifier of the channel within the specified team where the message will be posted.

contentstring

The content of the message to be sent. Can be plain text or HTML, determined by `content_type`.

content_typestring

The format of the message content. Supported values: 'text' (plain text) or 'html' (HTML content). Defaults to 'text'.default: text

team_idstring

The unique identifier of the Microsoft Teams team containing the channel.

MICROSOFT_TEAMS_TEAMS_POST_CHAT_MESSAGESends a non-empty message (text or HTML) to a specified, existing Microsoft Teams chat; content must be valid HTML if `content_type` is 'html'.3 params

Sends a non-empty message (text or HTML) to a specified, existing Microsoft Teams chat; content must be valid HTML if `content_type` is 'html'.

Parameters* required

chat_idstring

Unique identifier for the Microsoft Teams chat to receive the message.

contentstring

Message content, either plain text or HTML (see `content_type`).

content_typestring

Content format: 'text' (plain) or 'html'.default: text

MICROSOFT_TEAMS_TEAMS_POST_MESSAGE_REPLYSends a reply to an existing message, identified by `message_id`, within a specific `channel_id` of a given `team_id` in Microsoft Teams.5 params

Sends a reply to an existing message, identified by `message_id`, within a specific `channel_id` of a given `team_id` in Microsoft Teams.

Parameters* required

channel_idstring

The unique identifier of the channel within the specified team. This channel contains the message to which the reply will be posted. Channel IDs typically follow a format like '19:{alphanumeric_str...

contentstring

The body of the reply message. This can be plain text or HTML, as specified by the `content_type` field.

content_typestring

Specifies the format of the `content` field. Accepted values are 'text' for plain text content and 'html' for content with HTML formatting. Defaults to 'text' if not provided.default: text

message_idstring

The unique identifier of the specific message within the channel to which this reply is directed.

team_idstring

The unique identifier (GUID) of the Microsoft Teams team that contains the channel where the message to be replied to exists.

MICROSOFT_TEAMS_UNARCHIVE_TEAMTool to unarchive a Microsoft Teams team. Use when you need to restore an archived team to active state.1 params

Tool to unarchive a Microsoft Teams team. Use when you need to restore an archived team to active state.

Parameters* required

team_idstring

The unique identifier (GUID) of the team to unarchive.

MICROSOFT_TEAMS_UPDATE_CHANNEL_MESSAGETool to update a message in a channel. Use when you need to modify an existing channel message after confirming channel and message IDs.5 params

Tool to update a message in a channel. Use when you need to modify an existing channel message after confirming channel and message IDs.

Parameters* required

channel_idstring

Unique identifier of the channel within the team.

contentstring

Updated message content, either plain text or HTML.

content_typestring

Format of the message content: 'text' or 'html'.default: text

message_idstring

Unique identifier of the channel message to update.

team_idstring

Unique identifier of the Microsoft Teams team.

MICROSOFT_TEAMS_UPDATE_CHAT_MESSAGETool to update a specific message in a chat. Use when you need to correct or modify a sent chat message.4 params

Tool to update a specific message in a chat. Use when you need to correct or modify a sent chat message.

Parameters* required

chat_idstring

Unique identifier of the Microsoft Teams chat.

contentstring

Updated message content, either plain text or HTML.

content_typestring

Format of the message content: 'text' or 'html'.default: text

message_idstring

Unique identifier of the chat message to update.

MICROSOFT_TEAMS_UPDATE_TEAMTool to update the properties of a team. Use when you need to modify team settings such as member, messaging, or fun settings.4 params

Tool to update the properties of a team. Use when you need to modify team settings such as member, messaging, or fun settings.

Parameters* required

funSettingsobject

Settings that control fun features in the team.

memberSettingsobject

Settings that control what members can do in the team.

messagingSettingsobject

Settings that control messaging capabilities in the team.

team_idstring

The unique identifier (GUID) of the team to update.

Configuration

MS_CLIENT_ID*

Microsoft Entra (Azure AD) application client ID

MS_CONFIG_DIR*

Path to the per-user Microsoft config directory (credentials/, accounts.json)

MS_ACCOUNT_EMAIL

Account email when running in multi-account per-instance mode (falls back to the first account in accounts.json)

MS_MCP_PACKAGE_IDdefault: Microsoft365Teams

Logical package ID surfaced in error responses

MICROSOFT_REQUEST_TIMEOUT_MSdefault: 60000

Override the upstream Microsoft Graph request timeout in milliseconds (max 300000 = 5 min)

Readme

Rogue, the Rebel character for safe action and control

mcp-servers

Source-available MCP servers by Mindstone. Works with any MCP host — Claude Desktop, Cursor, Rebel, and others.

Browse all 35 connectors with their version, auth model, and tool count at the catalogue site (regenerated from each connector's STATUS.json on every push).

Connectors

View the full README on GitHub

Details

Repository: github.com/mindstone/mcp-servers
Category: Communication & Messaging
Package: @mindstone/mcp-server-microsoft-teams
Transport: STDIO
Auth: Required
Registry: MCP registry, active

Related Communication & Messaging MCP servers

View all

Outlook Emailmintmcp/serversA MCP server for Outlook email that lets you search, read, and draft emails and replies.0stars

Resend Email MCPhelbertparanhos/resend-email-mcpComplete Resend email MCP: full API coverage + debug layer (deliverability, DNS, bounces).1stars

Email Mcpmarlinjai/email-mcpUnified email MCP server for Gmail, Outlook, iCloud, and IMAP with batch operations13stars

HTML Email Playbookosamahassouna/docs-hubTeaches AI to write HTML email that renders in Outlook, Gmail, and Apple Mail. 21 rules, 6 comps.0stars

Agent Emailusejunior/email-agent-mcpLocal email connectivity for AI agents — read, draft, send, and organize Outlook mail via MCP7stars

Gmailgongrzhe/gmail-mcp-serverProvides Gmail integration with auto authentication, enabling email send, read, search, label management, and batch operations via MCP.1.1Kstars

Microsoft 365 Teams

Tools

Configuration

Readme

mcp-servers

Connectors

Details

More from mindstone

Related Communication & Messaging MCP servers