Microsoft Teams
surgeenterpriseai/teams-mcp-server
Connects Claude directly to Microsoft Teams via the Graph API, exposing 11 tools for reading and sending messages, listing teams and channels, searching chat history, and managing both channel threads and direct messages. Built for multi-tenant use with OAuth, so any M365 user can sign in with their work account and immediately get their own Teams data without Azure setup. Runs as stdio for Claude Desktop/Code with local token caching, or as HTTP with SSE for remote deployments. If you're building workflows that need Claude to monitor team channels, respond in threads, or search across your organization's Teams conversations, this is the bridge.
- GitHub stars
- 1
- tools
- 30
- transport
- STDIO
- last updated
- Apr 12, 2026
Tools
30 toolsPublic 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
rolesarrayRoles to assign to the member. Only 'owner' is supported. Omit or leave empty to add as a standard member.
team_idstringThe unique ID (GUID) of the Microsoft Team to which the member will be added.
user_idstringThe 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_membersbooleanIf true, sets the SharePoint site to read-only for team members when archiving.default: false
team_idstringThe 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
filterstringAn 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:
selectarrayA 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...
topintegerThe 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_idstringThe 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_idstringUnique identifier of the Microsoft Teams chat.
filterstringOData v4.0 filter query string for messages. If empty, no filtering is applied.default:
topintegerMaximum 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_timestringThe 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_requiredbooleanAn optional boolean indicating whether a passcode should be required to join this meeting. If not specified, the organization's default policy applies.
participantsarrayAn optional list of participants to invite to the meeting. Each participant is defined by their user ID and role.
start_date_timestringThe start date and time of the meeting, specified in ISO 8601 format (e.g., '2024-08-15T10:00:00Z').
subjectstringThe 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
descriptionstringBrief description of the team's purpose. Maximum 1024 characters. Note: Known template IDs for team creation: 'standard' (default), 'educationClass', 'educationStaff', 'educationProfessionalLearnin...
displayNamestringDisplay name of the team as it will appear in Microsoft Teams. Must be unique within the organization.
firstChannelNamestringName of the first channel created; defaults to 'General' if omitted.
membersarrayList 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_bindstringURL 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')
visibilitystringTeam visibility setting. 'private': Only owners can add members. 'public': Anyone in the organization can join. Default is 'public'.one of
private · publicdefault: publicMICROSOFT_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_idstringThe 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_idstringThe unique identifier of the channel within the specified team.
team_idstringThe 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_idstringUnique identifier of the Microsoft Teams chat that contains the message.
message_idstringUnique 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_idstringGUID 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_idstringUnique identifier of the channel within the team.
message_idstringUnique identifier of the channel message whose replies are to be listed.
team_idstringUnique identifier (GUID) of the Microsoft Teams team.
topintegerMaximum 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_idstringGUID of the Microsoft Teams team to retrieve members from.
topintegerOptional 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
countbooleanIf true, include a count of total matching templates in the response.default: false
filterstringOData filter expression to filter the templates (e.g., "startsWith(displayName,'Template')").default:
orderbystringComma-separated properties and directions to order the results by (e.g., 'displayName desc').default:
selectstringComma-separated template properties to include in the response (e.g., 'id,displayName,description'). If empty, default properties are returned.default:
skipintegerNumber of templates to skip for pagination.
topintegerMaximum 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
$expandstringOData expand related entities (e.g., `manager`).
$filterstringOData filter to refine results by property values (e.g., `startswith(displayName,'A')`).
$orderbystringOData orderby clause to sort results (e.g., `displayName desc`).
$selectstringComma-separated list of user properties to include (e.g., `id,displayName,mail`).
$skipintegerNumber of users to skip for pagination.
$topintegerMaximum number of users to return per page (1-999).
consistencyLevelstringSet 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_resultsbooleanIf `true`, sorts results by relevance; otherwise, sorts by date modified in descending order (newest first).default: false
from_indexintegerThe 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
querystringSearch query for files in Teams. Supports keywords, filenames, and content search.
**Basic Syntax:**
- Keywords: 'budget contract'
- Exact phrases: '"project timeline"'
- Filenames: 'report.pdf' o...
sizeintegerThe 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_resultsbooleanIf `true`, sorts results by relevance; otherwise, sorts by date in descending order (newest first).default: false
from_indexintegerThe 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). Mes...default: 0
querystringKQL (Keyword Query Language) search query string. Supports advanced syntax for precise searches.
**Basic Syntax:**
- Simple keywords: 'budget report'
- Exact phrases: '"quarterly review"'
- Boolea...default:
sizeintegerThe 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
descriptionstringAn optional, user-friendly description of the channel's purpose. Maximum length is 1024 characters.default:
membership_typestringMembership 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
namestringThe 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_idstringThe 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
chatTypestringType of chat. If 'oneOnOne' for members with an existing chat, that chat's details are returned.
membersarrayList 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.
topicstringSubject 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_idstringID of the Channel within the specified Team that contains the message.
message_idstringID of the message to retrieve from the channel.
team_idstringID 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
filterstringOData v4.0 filter string to refine results based on team properties (e.g., `startsWith(displayName,'A')`). Consult OData v4.0 documentation for syntax.default:
selectstringComma-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:
topintegerMaximum 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
filterstringOData v4 query string to filter channels (e.g., `startswith(displayName,'Sales')` or `membershipType eq 'private'`).default:
include_shared_channelsbooleanIf true, include channels shared with the team.default: false
selectstringComma-separated channel properties to return (e.g., 'id,displayName,description'); empty for default properties. Common: `id`, `displayName`, `description`, `email`, `membershipType`, `webUrl`.default:
team_idstringUnique 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_idstringUnique 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.
topintegerMaximum 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
filterstringOData $filter query to limit results (e.g., `"startsWith(displayName,'A')"`).
orderbystringOData $orderby expression to sort results (e.g., 'displayName asc, relevanceScore desc').
searchstringFuzzy search query (name, email, or topic like 'topic:marketing'). Effective only when `user_id` is 'me'.
selectstringComma-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...
skipintegerNumber of items to skip for pagination.
topintegerMaximum number of items per page for pagination. Actual count may be less. Service default if unspecified.
user_idstringIdentifier 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_idstringThe unique identifier of the channel within the specified team where the message will be posted.
contentstringThe content of the message to be sent. Can be plain text or HTML, determined by `content_type`.
content_typestringThe format of the message content. Supported values: 'text' (plain text) or 'html' (HTML content). Defaults to 'text'.default: text
team_idstringThe 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_idstringUnique identifier for the Microsoft Teams chat to receive the message.
contentstringMessage content, either plain text or HTML (see `content_type`).
content_typestringContent 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_idstringThe 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...
contentstringThe body of the reply message. This can be plain text or HTML, as specified by the `content_type` field.
content_typestringSpecifies 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_idstringThe unique identifier of the specific message within the channel to which this reply is directed.
team_idstringThe 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_idstringThe 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_idstringUnique identifier of the channel within the team.
contentstringUpdated message content, either plain text or HTML.
content_typestringFormat of the message content: 'text' or 'html'.default: text
message_idstringUnique identifier of the channel message to update.
team_idstringUnique 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_idstringUnique identifier of the Microsoft Teams chat.
contentstringUpdated message content, either plain text or HTML.
content_typestringFormat of the message content: 'text' or 'html'.default: text
message_idstringUnique 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
funSettingsobjectSettings that control fun features in the team.
memberSettingsobjectSettings that control what members can do in the team.
messagingSettingsobjectSettings that control messaging capabilities in the team.
team_idstringThe unique identifier (GUID) of the team to update.
Sponsors
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageReadme
Teams MCP Server
Let Claude read and send your Microsoft Teams messages. An open-source MCP server that connects Claude Code, Claude Desktop and Claude Cowork to Microsoft Teams: list your teams and channels, read channel and chat messages, search across Teams, and post or reply — all by asking Claude in plain English.
- What it does: gives Claude 11 Teams tools through Microsoft Graph, using your own Microsoft 365 sign-in. Claude sees only what you can already see in Teams. Messages pass through; nothing is stored except your sign-in token on your machine.
- Who it's for: people who live in Teams and use Claude — developers, team leads, support and ops people who want "summarise #standup since Monday" or "reply to Priya's question in #release" without switching windows. Also teams that want to host one shared Teams connector for everyone in their company.
- Cost: free and MIT-licensed. You need a Microsoft 365 work or school account and permission to register an app in Azure (or an admin who does it for you once).
Details
- Repository
- github.com/surgeenterpriseai/teams-mcp-server
- Website
- github.com/SurgeEnterpriseAI/teams-mcp-server
- Categories
- Communication & Messaging, Search & Web Crawling
- Package
microsoft-teams-mcp-server- Transport
- STDIO
- Registry
- MCP registry, active
Related Communication & Messaging MCP servers
View all
2
Emailprimitivedotdev/primitive-mono-repoEmail infrastructure for AI agents — send, receive, search, and reply to email over MCP.0stars
Emailprimitivedotdev/primitive-mono-repoEmail infrastructure for AI agents — send, receive, search, and reply to email over MCP.0stars3
SMS Validator APIbr0ski777/sms-validator-x402Validate SMS-capable phone numbers — mobile vs landline, E.164 format. x402 micropayment.0stars
SMS Validator APIbr0ski777/sms-validator-x402Validate SMS-capable phone numbers — mobile vs landline, E.164 format. x402 micropayment.0stars4
Whatsappgaviwhatsapp/gaviwhatsappSend WhatsApp messages from Cursor, Claude Code, and Codex via MCP.0stars
Whatsappgaviwhatsapp/gaviwhatsappSend WhatsApp messages from Cursor, Claude Code, and Codex via MCP.0stars5
ManyContacts - WhatsApp Business CRMmanycontacts/mcpWhatsApp Business CRM: send messages, manage contacts, campaigns, and AI agents.0stars
ManyContacts - WhatsApp Business CRMmanycontacts/mcpWhatsApp Business CRM: send messages, manage contacts, campaigns, and AI agents.0stars6
Outlookio.github.mcp-z/mcp-outlookOutlook integration with OAuth, message search, batch operations, and calendar management0stars
Outlookio.github.mcp-z/mcp-outlookOutlook integration with OAuth, message search, batch operations, and calendar management0stars