Microsoft Teams MCP Server & CLI

Ermöglichen Sie KI den einfachen Zugriff auf Microsoft Teams mit Ihrem normalen Teams-Login.

[!NOTE]

Kein Azure-Setup, keine App-Registrierung, Graph-Berechtigungen oder IT-Support erforderlich.

Durchsuchen Sie Nachrichten und E-Mails, holen Sie ungelesene Chats nach, lesen Sie Threads, senden Sie Antworten, rufen Sie Besprechungstranskripte ab und vieles mehr.

Warum msteams-mcp?

• Echte Arbeit erledigen – Suchen, ungelesene Chats, Threads, Antworten, Personen, Kanäle, Besprechungen, Transkripte, Dateien, Reaktionen und mehr.

• Einmal anmelden – Token werden automatisch aktualisiert und der Browser bleibt bei Routinevorgängen außen vor.

• Sicher – Der Assistent hat nur Ihre vorhandenen Teams-Berechtigungen, mit lokal verschlüsselten Sitzungsdaten.

• Überall nutzbar – Jede Funktion funktioniert sowohl über MCP-Clients als auch über die integrierte msteams-CLI.

Related MCP server: teams-mcp

Schnellstart

Voraussetzungen

• Node.js 18+

• Ein Microsoft-Konto mit Teams-Zugriff

• Installierter Google Chrome, Microsoft Edge oder Chromium-Browser

Konfigurieren Sie Ihren MCP-Client

Fügen Sie Ihrer MCP-Client-Konfiguration (z.B. Claude Desktop, Windsurf, Cursor) hinzu:

{
  "mcpServers": {
    "teams": {
      "command": "npx",
      "args": ["-y", "msteams-mcp@latest"]
    }
  }
}

Das war's. npx lädt die neueste Version herunter und führt sie aus. Bitten Sie Ihren Assistenten, einmal teams_login aufzurufen, schließen Sie die normale Microsoft-Anmeldung im Browser ab, und beginnen Sie dann mit der Nutzung von Teams.

Funktionsweise

Dieser Server greift direkt auf Microsofts Teams-Dienste zu (Substrate, chatsvc, CSA), wobei die authentifizierte Sitzung verwendet wird, die von der Teams-Web-App erstellt wurde.

1. teams_login öffnet einen Browser für Ihre normale Microsoft-Anmeldung.

2. Die resultierenden OAuth-Token und Sitzungsdaten werden verschlüsselt und lokal zwischengespeichert.

3. Routinevorgänge verwenden diese Token direkt, ohne Browser-Automatisierung.

4. Ablaufende Token werden automatisch über HTTP aktualisiert, mit Headless-Browser-SSO als Fallback.

Ihr Zugriff bleibt auf das beschränkt, was Ihr Teams-Konto bereits sehen und tun kann.

Aus dem Quellcode (Alternative)

Wenn Sie es vorziehen, aus einem lokalen Klon zu starten:

git clone https://github.com/m0nkmaster/msteams-mcp.git
cd msteams-mcp
npm install && npm run build

Konfigurieren Sie dann Ihren MCP-Client:

{
  "mcpServers": {
    "teams": {
      "command": "node",
      "args": ["/path/to/msteams-mcp/dist/index.js"]
    }
  }
}

Der Server verwendet Ihr systemeigenes Chrome (macOS/Linux) oder Edge (Windows) für die Authentifizierung.

CLI

Die gleiche Funktionalität ist auch als eigenständiges Kommandozeilentool msteams verfügbar. Dies ist nützlich, wenn Sie Teams aus einer Shell oder einem Skript statt über einen MCP-Client verwenden möchten.

Installieren Sie es global von npm:

npm install -g msteams-mcp

Dies installiert zwei Binärdateien: msteams-mcp (der MCP-Server) und msteams (der CLI-Wrapper). Oder führen Sie es ohne Installation aus:

npx -y msteams-mcp msteams status

Siehe CLI-Nutzung für Befehle.

Verfügbare Werkzeuge

Suche & Entdeckung

Nachrichtenübermittlung

Personen & Kontakte

Organisation

Reaktionen

Schnellreaktionen: like, heart, laugh, surprised, sad, angry können direkt ohne Suche verwendet werden.

Kalender & Besprechungen

teams_get_meetings gibt zurück: Betreff, Zeiten, Organisator, Beitritts-URL, threadId für den Besprechungschat. Verwenden Sie threadId mit teams_get_thread, um den Besprechungschat zu lesen, oder mit teams_get_transcript, um das vollständige Transkript mit Sprechern und Zeitstempeln zu erhalten.

Dateien

Gibt sowohl Dateien (Name, Erweiterung, URL, Größe) als auch Links (URL, Titel) zurück, zusammen mit der Person, die jedes Element geteilt hat. Funktioniert für Kanäle, Gruppenchats, 1:1-Chats und Besprechungschats.

Sitzung

Suchoperatoren

Sowohl teams_search (Teams-Nachrichten) als auch teams_search_email (E-Mails) unterstützen native Operatoren:

from:sarah@company.com     # Messages/emails from person
sent:2026-01-20            # From specific date
sent:>=2026-01-15          # Since date
in:project-alpha           # Messages in channel (Teams only)
subject:"budget"           # By subject (email)
"Rob Smith"                # Find @mentions (name in quotes)
hasattachment:true         # With files
is:unread                  # Unread emails (email only)
NOT from:email@co.com      # Exclude results

Kombinieren Sie Operatoren: from:sarah@co.com sent:>=2026-01-18 hasattachment:true

Hinweis: @me, from:me, to:me funktionieren NICHT. Verwenden Sie zuerst teams_get_me, um Ihre E-Mail/Anzeigenamen zu erhalten. sent:today funktioniert, aber sent:lastweek und sent:thisweek funktionieren NICHT – verwenden Sie explizite Daten oder lassen Sie sie weg (Ergebnisse sind nach Aktualität sortiert).

MCP-Ressourcen

Der Server stellt auch passive Ressourcen für die Kontextermittlung bereit:

CLI-Nutzung

msteams macht jedes Werkzeug verfügbar, das auch der MCP-Server bietet – volle Parität, gleiche Authentifizierung, gleiche Sitzungsdateien. Führen Sie es ohne Argumente aus, um alle Werkzeuge und Verknüpfungen aufzulisten.

Wenn Sie global installiert haben (npm install -g msteams-mcp), rufen Sie es direkt auf:

# List available tools and shortcuts
msteams

# Check authentication status
msteams status

# Log in (opens a browser; tries silent SSO first)
msteams login
msteams login --force        # clear session and re-login

# Search messages
msteams search "meeting notes"
msteams search "project" --from 0 --size 50

# Search emails
msteams teams_search_email --query "from:sarah@company.com"

# Send a message (default: your own notes/self-chat)
msteams send "Hello from Teams MCP!"
msteams send "Message" --to "conversation-id"

# People, contacts, favourites, activity, unread
msteams people "john smith"
msteams favorites
msteams activity
msteams unread

# Any tool by name (the teams_ prefix is optional)
msteams teams_search_emoji --query "heart"
msteams find_channel --query "support"

# Machine-readable output
msteams search "query" --json

Befehlsform: msteams <command> [primaryArg] [--key value ...]. Jeder nicht erkannte Befehl wird als Werkzeugname behandelt (teams_ wird automatisch hinzugefügt). Allgemeine Flags wie --to, --from, --size, --query, --force werden den passenden Werkzeugparametern zugeordnet; führen Sie msteams ohne Argumente aus, um die vollständige Liste zu sehen.

Aus einem Repository-Klon

Wenn Sie aus dem Quellcode arbeiten, ist dieselbe CLI mit npm run cli verbunden (läuft über tsx, kein Build erforderlich):

npm run cli                          # list tools
npm run cli -- search "your query"
npm run cli -- status
npm run cli -- send "Hi" --to "conversation-id"

Einschränkungen

• Anmeldung erforderlich – Führen Sie teams_login aus, um sich zu authentifizieren (öffnet Browser)

• Token-Ablauf – Tokens laufen nach ca. 1 Stunde ab; ein Headless-Refresh wird versucht, oder führen Sie bei Bedarf erneut teams_login aus

• Undokumentierte APIs – Nutzt Microsofts interne APIs, die sich ohne Vorankündigung ändern können

• Sucheinschränkungen – Nur Volltextsuche; Thread-Antworten, die nicht den Suchbegriffen entsprechen, werden nicht angezeigt (aber die LLM wird wahrscheinlich teams_get_thread für den vollständigen Kontext verwenden)

Sitzungsdateien

Sitzungsdateien werden in einem Benutzerkonfigurationsverzeichnis gespeichert (verschlüsselt):

• macOS/Linux: ~/.teams-mcp-server/

• Windows: %APPDATA%\teams-mcp-server\

Inhalt: session-state.json, token-cache.json, browser-profile/

Wenn Ihre Sitzung abläuft, rufen Sie teams_login auf oder löschen Sie das Konfigurationsverzeichnis.

Entwicklung

Für die lokale Entwicklung:

git clone https://github.com/m0nkmaster/msteams-mcp.git
cd msteams-mcp
npm install
npm run build

Entwicklungsbefehle:

npm run dev          # Run MCP server in dev mode
npm run build        # Compile TypeScript
npm run lint         # Run ESLint
npm test             # Run unit tests
npm run typecheck    # TypeScript type checking

Für die Entwicklung mit Hot Reload konfigurieren Sie Ihren MCP-Client:

{
  "mcpServers": {
    "teams": {
      "command": "npx",
      "args": ["tsx", "/path/to/msteams-mcp/src/index.ts"]
    }
  }
}

Siehe AGENTS.md für detaillierte Architektur- und Beitragsrichtlinien.