Skip to main content
Glama

Teams MCP

npm version npm downloads codecov License: MIT GitHub stars

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-Paginierung

    • Senden 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_message

  • send_chat_message

  • reply_to_channel_message

  • update_channel_message

  • update_chat_message

  • send_file_to_channel

  • send_file_to_chat

Formatierungsoptionen

Sie können den Parameter format angeben, um die Nachrichtenformatierung zu steuern:

  • text (Standard): Klartext

  • markdown: 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: # H1 bis ###### H6

  • Blockzitate: > quoted text

  • Tabellen: 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_messages

  • get_channel_messages

  • get_channel_message_replies

  • search_messages

  • get_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-Verarbeitung

  • raw: Gibt das ursprüngliche HTML von der Microsoft Graph API zurück

Was konvertiert wird

HTML-Element

Markdown-Ausgabe

<at id="0">Name</at> (Teams-Erwähnung)

@Name (mehrteilige Namen werden über Erwähnungs-Metadaten zusammengeführt)

<strong>text</strong>

**text**

<em>text</em>

*text*

<code>text</code>

`text`

<a href="url">text</a>

[text](url)

<ul><li>item</li></ul>

- item

<table>...</table>

GFM Markdown-Tabelle

<attachment id="...">

{attachment:id}

<systemEventMessage/>

(entfernt)

<hr>

---

&nbsp;, &amp;, etc.

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 lesen

  • User.ReadBasic.All - Basis-Benutzerinformationen lesen

  • Team.ReadBasic.All - Teaminformationen lesen

  • Channel.ReadBasic.All - Kanalinformationen lesen

  • ChannelMessage.Read.All - Kanalnachrichten lesen

  • ChannelMessage.Send - Kanalnachrichten und Antworten senden

  • ChannelMessage.ReadWrite - Kanalnachrichten bearbeiten und löschen

  • Chat.Read - Chatnachrichten lesen (enthalten über schreibgeschützte Scopes)

  • Chat.ReadWrite - Chats erstellen und verwalten, Chatnachrichten senden/bearbeiten/löschen (ersetzt Chat.Read)

  • TeamMember.Read.All - Teammitglieder lesen

  • Files.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.Read

  • User.ReadBasic.All

  • Team.ReadBasic.All

  • Channel.ReadBasic.All

  • ChannelMessage.Read.All

  • TeamMember.Read.All

  • Chat.Read

Authentifizierungsmodi

Vollzugriff:

npx @floriscornel/teams-mcp@latest authenticate

Schreibgeschützter Zugriff:

npx @floriscornel/teams-mcp@latest authenticate --read-only

Direkte 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.json gespeichert

  • Token-Cache wird lokal unter ~/.teams-mcp-token-cache.json gespeichert

🛠️ 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.js

CLI-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 Modus

  • AUTH_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=true

  • CLI-Flag: --read-only

Authentifizierung mit reduzierten Scopes:

npx @floriscornel/teams-mcp@latest authenticate --read-only

MCP-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 authenticate

Schreibgeschü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 abrufen

  • search_users - Nach Benutzern per Name oder E-Mail suchen

  • get_user - Detaillierte Benutzerinformationen per ID oder E-Mail abrufen

Teams-Operationen

  • list_teams - Liste der Teams, denen der Benutzer beigetreten ist

  • list_channels - Liste der Kanäle in einem bestimmten Team

  • get_channel_messages - Nachrichten aus einem Teamkanal abrufen, inklusive Zusammenfassungen von Anhängen und Auswahl des Inhaltsformats

  • get_channel_message_replies - Antworten auf eine bestimmte Kanalnachricht abrufen

  • send_channel_message - Nachricht an einen Teamkanal senden, mit optionalen Erwähnungen, Wichtigkeit und Bildanh

Available Tools

19 tools
auth_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

    A3.5/5.0

    Scored across 19 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness5/5

    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

    ActivitySlowing
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      A
      maintenance
      A 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.
      203
      104,785 npm
      1,150
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Model Context Protocol servers for Microsoft 365, enabling AI assistants to interact with Calendar, Contacts, OneDrive, Outlook, and SharePoint via the Microsoft Graph API.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server enabling AI assistants to interact with Microsoft Teams, users, chats, and organizational data via Microsoft Graph APIs.
      MIT