Teams MCP
Teams MCP
Ein Model Context Protocol (MCP)-Server, der eine nahtlose Integration mit Microsoft Graph-APIs bietet und es KI-Assistenten ermöglicht, mit Microsoft Teams, Benutzern, Chats, Dateien und Organisationsdaten zu interagieren.
📦 Installation
Um diesen MCP-Server in Cursor/Claude/VS Code zu verwenden, fügen Sie die folgende Konfiguration hinzu:
{
"mcpServers": {
"teams-mcp": {
"command": "npx",
"args": ["-y", "@floriscornel/teams-mcp@latest"]
}
}
}Related MCP server: Microsoft Graph MCP Server
🚀 Funktionen
🔐 Authentifizierung
OAuth 2.0-Gerätecode-Authentifizierungsablauf mit Microsoft Graph
Sichere Token-Verwaltung, Cache-Persistenz und Erneuerung von Refresh-Tokens
Überprüfung des Authentifizierungsstatus und Unterstützung für Abmeldungen
Schreibgeschützter Modus mit reduzierten Berechtigungsbereichen (Scopes)
Direkte
AUTH_TOKEN-Unterstützung für vorab ausgestellte Microsoft Graph-Zugriffstokens
👥 Benutzerverwaltung
Informationen zum aktuellen Benutzer abrufen
Suche nach Benutzern per Name oder E-Mail
Detaillierte Benutzerprofile abrufen
Zugriff auf Daten des Organisationsverzeichnisses
🏢 Microsoft Teams-Integration
Teams-Verwaltung
Liste der Teams, denen der Benutzer beigetreten ist
Zugriff auf Teamdetails und Metadaten
Kanal-Operationen
Liste der Kanäle innerhalb von Teams
Abrufen von Kanalnachrichten und Antworten
Senden von Nachrichten an Teamkanäle
Antworten auf bestehende Kanal-Threads
Bearbeiten und logisches Löschen von Kanalnachrichten und Antworten
Unterstützung für Nachrichtenwichtigkeitsstufen (
normal,high,urgent)Unterstützung für Inline-Bildanhänge via URL oder Base64-Daten
Teammitglieder
Liste der Teammitglieder und deren Rollen
Zugriff auf Mitgliederinformationen
Suche nach Benutzern für
@mentions
💬 Chat & Messaging
1:1- und Gruppen-Chats
Liste der Chats des Benutzers
Erstellen neuer 1:1- oder Gruppenunterhaltungen
Abrufen des Chat-Nachrichtenverlaufs mit Filtern, Sortierung und Paginierung
Abrufen aller verfügbaren Nachrichten via
@odata.nextLink-PaginierungSenden von Nachrichten an bestehende Chats
Bearbeiten zuvor gesendeter Chat-Nachrichten
Logisches Löschen von Chat-Nachrichten
✏️ Nachrichtenverwaltung
Bearbeiten & Löschen
Aktualisieren (Bearbeiten) gesendeter Nachrichten in Chats und Kanälen
Logisches Löschen von Nachrichten in Chats und Kanälen (wird als gelöscht markiert, ohne dauerhafte Entfernung)
Nur Nachrichtenabsender können ihre eigenen Nachrichten aktualisieren/löschen
Unterstützung für Markdown-Formatierung, Erwähnungen und Wichtigkeitsstufen bei Bearbeitungen
📎 Medien & Anhänge
Gehostete Inhalte
Herunterladen gehosteter Inhalte (Bilder, Dateien) aus Chat- und Kanalnachrichten
Zugriff auf Inline-Bilder und Anhänge, die in Unterhaltungen geteilt wurden
Optionales direktes Speichern gehosteter Inhalte auf der Festplatte
Datei-Upload
Hochladen und Senden beliebiger Dateitypen (PDF, DOCX, XLSX, ZIP, Bilder usw.) an Kanäle und Chats
Unterstützung für große Dateien (>4 MB) über fortsetzbare Upload-Sitzungen
Kanal-Uploads erfolgen in SharePoint, Chat-Uploads in OneDrive
Optionaler Nachrichtentext, benutzerdefinierter Dateiname, Formatierung und Wichtigkeitsstufen
🔍 Erweiterte Suche & Erkennung
Nachrichtensuche
Suche über alle Teams-Kanäle und Chats hinweg unter Verwendung der Microsoft Search API
Unterstützung für KQL (Keyword Query Language)-Syntax
Filtern nach Absender, Erwähnungen, Anhängen, Lesestatus und Datumsbereichen
Abrufen aktueller Nachrichten mit erweiterten Filteroptionen
Finden von Nachrichten, die den aktuellen Benutzer erwähnen
Unterstützung für Rich-Message-Formatierung
Die folgenden Tools unterstützen Rich-Message-Formatierung in Teams-Kanälen und Chats:
send_channel_messagesend_chat_messagereply_to_channel_messageupdate_channel_messageupdate_chat_messagesend_file_to_channelsend_file_to_chat
Formatierungsoptionen
Sie können den Parameter format angeben, um die Nachrichtenformatierung zu steuern:
text(Standard): Klartextmarkdown: Markdown-Formatierung (fett, kursiv, Listen, Links, Code usw.), die in bereinigtes HTML konvertiert wird
Wenn format auf markdown gesetzt ist, wird der Nachrichteninhalt mithilfe eines sicheren Markdown-Parsers in HTML konvertiert und bereinigt, um potenziell gefährliche Inhalte zu entfernen, bevor sie an Teams gesendet werden.
Wenn format nicht angegeben ist, wird die Nachricht als Klartext gesendet.
Beispielanwendung
{
"teamId": "...",
"channelId": "...",
"message": "**Bold text** and _italic text_\n\n- List item 1\n- List item 2\n\n[Link](https://example.com)",
"format": "markdown",
"importance": "high"
}{
"chatId": "...",
"message": "Simple plain text message",
"format": "text"
}Sicherheitsfunktionen
HTML-Bereinigung: Alle Markdown-Inhalte werden in HTML konvertiert und bereinigt, um potenziell gefährliche Elemente (Skripte, Event-Handler usw.) zu entfernen
Erlaubte Tags: Nur sichere HTML-Tags sind zulässig (p, strong, em, a, ul, ol, li, h1-h6, code, pre usw.)
Sichere Attribute: Nur sichere Attribute sind erlaubt
XSS-Prävention: Inhalte werden automatisch bereinigt, um Cross-Site-Scripting-Angriffe zu verhindern
Unterstützte Markdown-Funktionen
Textformatierung: Fett (
**text**), kursiv (_text_), durchgestrichen (~~text~~)Links:
[text](url)Listen: Mit Aufzählungszeichen (
- item) und nummeriert (1. item)Code: Inline
`code`und Code-BlöckeÜberschriften:
# H1bis###### H6Blockzitate:
> quoted textTabellen: GitHub-flavored Markdown-Tabellen
LLM-freundliches Inhaltsformat
Nachrichten, die von der Microsoft Graph API abgerufen werden, werden als rohes HTML mit Teams-spezifischen Tags zurückgegeben. Um diesen Inhalt für KI-Assistenten besser verwertbar zu machen, unterstützen die folgenden Tools eine automatische HTML-zu-Markdown-Konvertierung:
get_chat_messagesget_channel_messagesget_channel_message_repliessearch_messagesget_my_mentions
Optionen für das Inhaltsformat
Verwenden Sie den Parameter contentFormat, um zu steuern, wie der Nachrichteninhalt zurückgegeben wird:
markdown(Standard): Konvertiert Teams-HTML in sauberes Markdown, optimiert für die LLM-Verarbeitungraw: Gibt das ursprüngliche HTML von der Microsoft Graph API zurück
Was konvertiert wird
HTML-Element | Markdown-Ausgabe |
|
|
|
|
|
|
|
|
|
|
|
|
| GFM Markdown-Tabelle |
|
|
| (entfernt) |
|
|
| Zu einfachen Zeichen dekodiert |
Anhang-Metadaten
Nachrichten, die Dateianhänge oder Inline-Bilder enthalten, beinhalten ein attachments-Array in der Antwort mit Metadaten für jeden Anhang (id, name, contentType, contentUrl, thumbnailUrl). Die Inline-Marker {attachment:id} im Markdown-Inhalt korrelieren mit Einträgen in diesem Array, was es Konsumenten ermöglicht, Anhänge über download_message_hosted_content oder download_chat_hosted_content zu identifizieren und herunterzuladen.
Beispielanwendung
{
"chatId": "19:meeting_...",
"limit": 10,
"contentFormat": "markdown"
}Um das ursprüngliche HTML zu erhalten:
{
"chatId": "19:meeting_...",
"limit": 10,
"contentFormat": "raw"
}📦 Installation
# Install dependencies
npm install
# Build the project
npm run build
# Set up authentication
npm run auth🔧 Konfiguration
Voraussetzungen
Node.js 18+
Microsoft 365-Konto mit entsprechenden Berechtigungen
Delegierte Microsoft Graph-Berechtigungen für die unten aufgeführten Scopes
Erforderliche Microsoft Graph-Berechtigungen
Vollständiger Modus (Standard):
User.Read- Benutzerprofil lesenUser.ReadBasic.All- Basis-Benutzerinformationen lesenTeam.ReadBasic.All- Teaminformationen lesenChannel.ReadBasic.All- Kanalinformationen lesenChannelMessage.Read.All- Kanalnachrichten lesenChannelMessage.Send- Kanalnachrichten und Antworten sendenChannelMessage.ReadWrite- Kanalnachrichten bearbeiten und löschenChat.Read- Chatnachrichten lesen (enthalten über schreibgeschützte Scopes)Chat.ReadWrite- Chats erstellen und verwalten, Chatnachrichten senden/bearbeiten/löschen (ersetztChat.Read)TeamMember.Read.All- Teammitglieder lesenFiles.ReadWrite.All- Erforderlich für Datei-Uploads in Kanäle und Chats
Schreibgeschützter Modus (TEAMS_MCP_READ_ONLY=true) — nur diese Scopes werden angefordert:
User.ReadUser.ReadBasic.AllTeam.ReadBasic.AllChannel.ReadBasic.AllChannelMessage.Read.AllTeamMember.Read.AllChat.Read
Authentifizierungsmodi
Vollzugriff:
npx @floriscornel/teams-mcp@latest authenticateSchreibgeschützter Zugriff:
npx @floriscornel/teams-mcp@latest authenticate --read-onlyDirekte Token-Injektion mit einem bestehenden Microsoft Graph JWT:
{
"mcpServers": {
"teams-mcp": {
"command": "npx",
"args": ["-y", "@floriscornel/teams-mcp@latest"],
"env": {
"AUTH_TOKEN": "<jwt-for-https://graph.microsoft.com>"
}
}
}
}Token-Speicherung
Auth-Metadaten werden lokal unter
~/.msgraph-mcp-auth.jsongespeichertToken-Cache wird lokal unter
~/.teams-mcp-token-cache.jsongespeichert
🛠️ Verwendung
Starten des Servers
# Development mode with hot reload
npm run dev
# Production mode
npm run build && node dist/index.js
# Start in read-only mode (disables all write tools)
TEAMS_MCP_READ_ONLY=true node dist/index.jsCLI-Befehle
npx @floriscornel/teams-mcp@latest authenticate # Authenticate with full scopes
npx @floriscornel/teams-mcp@latest authenticate --read-only # Authenticate with read-only scopes
npx @floriscornel/teams-mcp@latest check # Check authentication status
npx @floriscornel/teams-mcp@latest logout # Clear authentication
npx @floriscornel/teams-mcp@latest auth # Alias for authenticate
npx @floriscornel/teams-mcp@latest # Start MCP server (default)Umgebungsvariablen
TEAMS_MCP_READ_ONLY=true- Startet den MCP-Server im schreibgeschützten ModusAUTH_TOKEN=<jwt>- Verwendet ein bereits vorhandenes Microsoft Graph-Zugriffstoken anstelle des MSAL-Logins
Schreibgeschützter Modus
Der Server unterstützt einen schreibgeschützten Modus, der alle Schreibvorgänge deaktiviert (Nachrichten senden, Chats erstellen, Dateien hochladen, Nachrichten bearbeiten/löschen) und nur Lese-Berechtigungen von Microsoft Graph anfordert.
Schreibgeschützten Modus aktivieren entweder über:
Umgebungsvariable:
TEAMS_MCP_READ_ONLY=trueCLI-Flag:
--read-only
Authentifizierung mit reduzierten Scopes:
npx @floriscornel/teams-mcp@latest authenticate --read-onlyMCP-Serverkonfiguration (schreibgeschützt):
{
"mcpServers": {
"teams-mcp": {
"command": "npx",
"args": ["-y", "@floriscornel/teams-mcp@latest"],
"env": {
"TEAMS_MCP_READ_ONLY": "true"
}
}
}
}Moduswechsel: Beim Wechsel vom schreibgeschützten in den Vollmodus erkennt der Server die Diskrepanz bei den Scopes und warnt Sie, sich erneut zu authentifizieren:
npx @floriscornel/teams-mcp@latest authenticateSchreibgeschützte Tools (16):
auth_status, get_current_user, search_users, get_user, list_teams, list_channels, get_channel_messages, get_channel_message_replies, list_team_members, search_users_for_mentions, download_message_hosted_content, list_chats, get_chat_messages, download_chat_hosted_content, search_messages, get_my_mentions
Schreib-Tools im schreibgeschützten Modus deaktiviert (10):
send_channel_message, reply_to_channel_message, update_channel_message, delete_channel_message, send_file_to_channel, send_chat_message, create_chat, update_chat_message, delete_chat_message, send_file_to_chat
Verfügbare MCP-Tools
Authentifizierung
auth_status- Aktuellen Authentifizierungsstatus prüfen
Benutzeroperationen
get_current_user- Informationen zum authentifizierten Benutzer abrufensearch_users- Nach Benutzern per Name oder E-Mail suchenget_user- Detaillierte Benutzerinformationen per ID oder E-Mail abrufen
Teams-Operationen
list_teams- Liste der Teams, denen der Benutzer beigetreten istlist_channels- Liste der Kanäle in einem bestimmten Teamget_channel_messages- Nachrichten aus einem Teamkanal abrufen, inklusive Zusammenfassungen von Anhängen und Auswahl des Inhaltsformatsget_channel_message_replies- Antworten auf eine bestimmte Kanalnachricht abrufensend_channel_message- Nachricht an einen Teamkanal senden, mit optionalen Erwähnungen, Wichtigkeit und Bildanh
Available Tools
19 toolsauth_statusA
Check the authentication status of the Microsoft Graph connection. Returns whether the user is authenticated and shows their basic profile information.
Inputs: no named parameters.
create_chatC
Create a new chat conversation. Can be a 1:1 chat (with one other user) or a group chat (with multiple users). Group chats can optionally have a topic.
Inputs: userEmails (required), topic.
get_channel_message_repliesC
Get all replies to a specific message in a channel. Returns reply content, sender information, and timestamps.
Inputs: teamId (required), channelId (required), messageId (required), limit.
get_channel_messagesC
Retrieve recent messages from a specific channel in a Microsoft Team. Returns message content, sender information, and timestamps.
Inputs: teamId (required), channelId (required), limit.
get_chat_messagesB
Retrieve recent messages from a specific chat conversation. Returns message content, sender information, and timestamps.
Inputs: chatId (required), limit, since, until, +3 more.
get_current_userA
Get the current authenticated user's profile information including display name, email, job title, and department.
Inputs: no named parameters.
get_my_mentionsA
Find all recent messages where the current user was mentioned (@mentioned) across Teams channels and chats.
Inputs: hours, limit, scope.
get_recent_messagesC
Get recent messages from across Teams with advanced filtering options. Can filter by time range, scope (channels vs chats), teams, channels, and users.
Inputs: hours, limit, mentionsUser, fromUser, +6 more.
get_userC
Get detailed information about a specific user by their ID or email address. Returns profile information including name, email, job title, and department.
Inputs: userId (required).
list_channelsB
List all channels in a specific Microsoft Team. Returns channel names, descriptions, types, and IDs for the specified team.
Inputs: teamId (required).
list_chatsB
List all recent chats (1:1 conversations and group chats) that the current user participates in. Returns chat topics, types, and participant information.
Inputs: no named parameters.
list_team_membersB
List all members of a specific Microsoft Team. Returns member names, email addresses, roles, and IDs.
Inputs: teamId (required).
list_teamsA
List all Microsoft Teams that the current user is a member of. Returns team names, descriptions, and IDs.
Inputs: no named parameters.
reply_to_channel_messageB
Reply to a specific message in a channel. Supports text and markdown formatting, mentions, and importance levels.
Inputs: teamId (required), channelId (required), messageId (required), message (required), +7 more.
search_messagesA
Search for messages across all Microsoft Teams channels and chats using Microsoft Search API. Supports advanced KQL syntax for filtering by sender, mentions, attachments, and more.
Inputs: query (required), scope, limit, enableTopResults.
search_usersA
Search for users in the organization by name or email address. Returns matching users with their basic profile information.
Inputs: query (required).
search_users_for_mentionsA
Search for users to mention in messages. Returns users with their display names, email addresses, and mention IDs.
Inputs: query (required), limit.
send_channel_messageC
Send a message to a specific channel in a Microsoft Team. Supports text and markdown formatting, mentions, and importance levels.
Inputs: teamId (required), channelId (required), message (required), importance, +6 more.
send_chat_messageC
Send a message to a specific chat conversation. Supports text and markdown formatting, mentions, and importance levels.
Inputs: chatId (required), message (required), importance, format, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 19 tools
Most tools have distinct purposes targeting specific resources like channels, chats, users, or messages, but there is some overlap: get_recent_messages and search_messages both retrieve messages with filtering, which could cause confusion. However, descriptions clarify that get_recent_messages focuses on recent messages with time/scope filters, while search_messages uses advanced KQL syntax, helping to differentiate them.
Tool names follow a highly consistent verb_noun pattern throughout, such as list_teams, get_channel_messages, send_chat_message, and search_users. All tools use snake_case with clear verbs like get, list, create, send, reply, and search, making the set predictable and easy to understand.
With 19 tools, the count is slightly high but reasonable for a comprehensive Teams integration covering authentication, chats, channels, messages, users, and search. It provides broad functionality without being overwhelming, though it could be streamlined by merging some overlapping tools like get_recent_messages and search_messages.
The toolset offers complete coverage for Microsoft Teams interactions, including CRUD operations for messages (send, reply, get), resource listing (teams, channels, chats, members), user management (get, search), and authentication. There are no obvious gaps; agents can perform core workflows like messaging, searching, and team management effectively.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
The Telnyx MCP server is an official implementation of the Model Context Protocol that enables AI clients (like Claude Desktop, Cursor, and OpenAI Agents) to interact with Telnyx's telephony, messaging, and AI assistant APIs. It provides comprehensive capabilities including making and managing phone calls, sending SMS/MMS messages, purchasing and configuring phone numbers, creating AI assistants with custom instructions, managing cloud storage buckets, scraping and embedding website content, and handling integration secrets. The server exists as both a local implementation and a remotely hosted version, allowing developers to integrate real-world communication infrastructure directly into AI applications.
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
Related MCP Servers
- AlicenseBqualityAmaintenanceA Model Context Protocol server that enables interaction with Microsoft 365 services (Excel, Calendar, Mail, OneDrive, Teams, etc.) through the Graph API, allowing AI assistants to manage Microsoft 365 resources via natural language.203104,785 npm1,150MIT
- AlicenseNot gradedqualityDmaintenanceA comprehensive server that enables AI applications to interact with Microsoft 365 and Azure AD services through standardized Model Context Protocol interfaces.3MIT
- AlicenseNot gradedqualityDmaintenanceModel Context Protocol servers for Microsoft 365, enabling AI assistants to interact with Calendar, Contacts, OneDrive, Outlook, and SharePoint via the Microsoft Graph API.MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server enabling AI assistants to interact with Microsoft Teams, users, chats, and organizational data via Microsoft Graph APIs.MIT