Microsoft Teams MCP Server
Official Microsoft-hosted MCP server for managing Teams chats, channels, users, and messages via the Microsoft Graph API.
The Microsoft Teams MCP server is an official, Microsoft-hosted remote MCP endpoint listed in the microsoft/mcp catalog of first-party Model Context Protocol servers. It exposes Microsoft Teams operations through the Microsoft Graph API, allowing AI agents to read and act on chats, channels, users, and messages inside a tenant.
Per the Microsoft catalog entry, the server features server-side filtering, pagination, and token optimization, making it suitable for tenants with large volumes of Teams data. It is delivered as a hosted HTTP MCP endpoint scoped to a Microsoft Entra tenant, so there is no package to install or container to run. Authentication is performed against Microsoft Entra ID for the calling user, and the server URL embeds the tenant GUID.
This entry is part of Microsoft's broader Agent365 / Microsoft 365 MCP surface, which also includes hosted servers for Microsoft 365 Mail, Calendar, Copilot Chat, Word, OneDrive/SharePoint, and Dataverse. Because the server is provider-hosted, capabilities and exact tool names are governed by Microsoft and may evolve without a public source repository to inspect.
Tools
| Tool | Description |
|---|---|
Teams chats |
Read and manage one-to-one and group chat threads in Microsoft Teams via Microsoft Graph. |
Teams channels |
List and inspect channels within Teams (teams) and their messages, with server-side filtering and pagination. |
Teams messages |
Read and post messages and replies in chats and channels, with token-optimized responses. |
Teams users |
Look up users in the tenant directory via Microsoft Graph for use in Teams operations. |
Prerequisites
- A Microsoft 365 tenant with Microsoft Teams enabled
- Your Microsoft Entra tenant ID (a GUID), available from the Entra admin center
- An MCP client that supports remote HTTP MCP servers (e.g. VS Code, VS Code Insiders, Claude Desktop with HTTP support)
- A signed-in user account with appropriate Microsoft Graph permissions for Teams (e.g. Chat.Read, ChannelMessage.Read.All, User.Read)
One-click install
The Microsoft catalog provides one-click install buttons for VS Code and VS Code Insiders that prompt for the tenant ID at install time. These point at the hosted server URL:
https://agent365.svc.cloud.microsoft/agents/tenants/{tenant_id}/servers/mcp_TeamsServer
Manual VS Code config
Add the following to your VS Code MCP configuration, replacing <YOUR_TENANT_ID> with your Entra tenant GUID:
{
"servers": {
"agent365-teamsserver": {
"type": "http",
"url": "https://agent365.svc.cloud.microsoft/agents/tenants/<YOUR_TENANT_ID>/servers/mcp_TeamsServer"
}
}
}
Authentication
Authentication is handled via Microsoft Entra ID when the MCP client first connects to the URL. Sign in with a tenant user that has the Graph permissions needed for the Teams operations you plan to perform.
- Summarize unread messages across a user's Teams chats and channels at the start of the day
- Search a specific channel for messages matching a topic or keyword and produce a digest
- Draft and post status updates or announcements from an agent into a chosen Teams channel
- Look up a colleague by name in the tenant directory and start or continue a Teams chat with them
- Triage a busy chat by extracting action items and decisions across recent messages
- "Summarize all unread messages from my Teams chats in the last 24 hours."
- "Find messages in the #product-launch channel mentioning the May release and list owners and deadlines."
- "Post a message in my chat with Priya saying I'll be 10 minutes late to our 3pm sync."
- "List the channels in the Marketing team and show the most recent message in each."
- "Look up the user Alex Chen in our tenant and start a new Teams chat asking for the Q2 roadmap doc."
- Official Microsoft-hosted server, no local install, container, or self-hosting required
- Backed by Microsoft Graph, so it inherits Graph's authentication, authorization, and tenant isolation
- Built-in server-side filtering, pagination, and token optimization for large Teams datasets
- Part of a coherent Microsoft 365 / Agent365 MCP family covering Mail, Calendar, Word, SharePoint, and more
- Closed implementation: no public source repository, so exact tool names and parameters are not openly documented
- Requires a Microsoft Entra tenant and appropriate Graph permissions; not usable for personal Microsoft accounts without M365
- Tenant admins may need to consent to the underlying Graph scopes before users can use it
- InditexTech/mcp-teams-server: community open-source Teams MCP server for reading, posting, and mentioning in messages
- floriscornel/teams-mcp: community MCP server with broader Microsoft Graph coverage including Teams, chats, files, and users
- pnp/cli-microsoft365-mcp-server: community MCP server that wraps the CLI for Microsoft 365 to manage Teams and other M365 workloads