Skip to main content
Glama

Outlook MCP Server

Microsoft Outlook Web (OWA) MCP-Server auf Basis einer Playwright Browser-Bridge. Steuert den echten Outlook Webclient im Chromium, Chrome oder Edge über CDP – keine komplexen Azure AD App Registrierungen oder Graph-API Admin-Consents erforderlich. Funktioniert direkt mit echten Browser-Sessions und ohne Cloud-Relay.

Ermöglicht LLM-Agenten (Antigravity, opencode, Claude Desktop, Cursor, …) den Lese- und Entwurfszugriff auf Microsoft Outlook: E-Mails suchen, Posteingang und Ordner durchsuchen, E-Mails als Markdown inklusive Teams-Besprechungslinks auslesen sowie neue E-Mail-Entwürfe sicher anlegen.

Hinweis: Dieses Repository ist vollständig organisationsneutral. Es enthält keine firmenspezifischen Accounts oder Zugangsdaten. Der gewünschte Tenant/Realm (z.B. adesso.de, d-velop.de oder eine beliebige Microsoft 365 Domain) kann frei über Umgebungsvariablen oder direkt im Login-Tool angegeben werden.


Features

  • 11 leistungsfähige MCP-Tools:

    • outlook_status: Prüft Verbindungs- und Anmeldestatus von Outlook Web.

    • outlook_login: Öffnet ein sichtbares Browserfenster für den einmaligen interaktiven Login (inkl. SSO / MFA).

    • outlook_search: Volltextsuche über das OWA-Suchfeld (nach Kunden, Tickets, Absendern, Stichwörtern).

    • outlook_get_email: Liest eine E-Mail vollständig im Lesebereich aus (konvertiert in Markdown, extrahiert Teams-Links und Metadaten).

    • outlook_list_recent: Schnelle Übersicht über die neuesten E-Mails im Posteingang.

    • outlook_create_draft: Legt E-Mail-Entwürfe im Ordner „Entwürfe“ (Drafts) an (per OWA DeepLink & Ctrl+S).

    • outlook_list_folders: Listet alle Navigationsordner (Posteingang, Gesendet, Archiv, Entwürfe etc.).

    • outlook_navigate_folder: Wechselt gezielt in einen bestimmten Ordner (z.B. Sent Items, Archiv).

    • outlook_bulk_list: Scroll-Enumeration zur Überwindung der OWA-Listen-Virtualisierung (erfasst alle Conversation-IDs).

    • outlook_read_email: Liest gezielt eine E-Mail anhand ihrer Conversation-ID aus.

    • outlook_close: Beendet die Hintergrund-Browserinstanz.

  • Sicherheits-Konzept (Draft-First): Es gibt kein Blindversenden von Mails. Der Server legt Entwürfe an, sodass der Anwender die Nachricht vor dem Absenden in Outlook sichten und freigeben kann.

  • Auto-Erkennung von Browsern: Findet automatisch Chromium/Chrome/Edge unter Linux, WSL, macOS und Windows (oder via OUTLOOK_MCP_CHROME_PATH).

  • Persistentes lokales Profil: Anmeldedaten und MFA-Tokens verbleiben sicher im lokalen Profil (~/.outlook-browser-profile).


Related MCP server: mcp-outlook-mail

Voraussetzungen

  • Node.js ≥ 20

  • Ein installierter Browser: Google Chrome, Microsoft Edge oder Playwright Chromium (npx playwright install chromium).

  • (Unter WSL/Linux) WSLg oder ein laufender X-Server für das einmalige Login-Fenster.


Installation

git clone https://github.com/pipelinedave/outlook-mcp.git
cd outlook-mcp
npm install

Konfiguration (Umgebungsvariablen)

Alle Umgebungsvariablen sind optional:

Variable

Beschreibung

Standard

OUTLOOK_MCP_REALM

Standard-Tenant/Domain für OWA (z.B. adesso.de, d-velop.de)

d-velop.de

OUTLOOK_MCP_CHROME_PATH

Expliziter Pfad zur Browser-Executable

Automatische Erkennung

OUTLOOK_MCP_PROFILE_DIR

Speicherort für das Browser-Profil

~/.outlook-browser-profile

OUTLOOK_MCP_HEADLESS

Headless-Modus (true / false)

true


Einbindung in MCP-Clients

Antigravity / Claude Desktop / Cursor / opencode

Füge den Server in deine MCP-Konfigurationsdatei (z.B. mcp_config.json oder opencode.json) ein:

{
  "mcpServers": {
    "outlook": {
      "command": "node",
      "args": ["/pfad/zu/outlook-mcp/index.js"],
      "env": {
        "OUTLOOK_MCP_REALM": "adesso.de"
      }
    }
  }
}

Oder unter WSL mit Node-Wrapper:

#!/bin/bash
export PATH="$HOME/.nvm/versions/node/v20.20.2/bin:$PATH"
export DISPLAY="${DISPLAY:-:0}"
export WAYLAND_DISPLAY="${WAYLAND_DISPLAY:-wayland-0}"
export XDG_RUNTIME_DIR="${XDG_RUNTIME_DIR:-/mnt/wslg/runtime-dir}"
export PULSE_SERVER="${PULSE_SERVER:-/mnt/wslg/PulseServer}"

exec node /pfad/zu/outlook-mcp/index.js "$@"

Erste Schritte (Login)

  1. Rufe das Tool outlook_login auf:

    {
      "realm": "adesso.de"
    }
  2. Es öffnet sich ein sichtbares Browserfenster. Melde dich dort wie gewohnt bei deinem Microsoft 365 Account an (inkl. MFA/Passkey).

  3. Sobald dein Posteingang geladen ist, kannst du das Fenster schließen oder geöffnet lassen.

  4. Prüfe mit outlook_status den Verbindungsstatus.

  5. Das Profil wird dauerhaft lokal gespeichert – zukünftige MCP-Aufrufe laufen vollautomatisch im Hintergrund (Headless).


Tests & Syntaxprüfung

npm run check       # Überprüft JS-Syntax aller Dateien
npm test            # Führt Unit-Tests via node:test aus

Lizenz

MIT License – siehe LICENSE.

Available Tools

11 tools
outlook_bulk_listC

Listet ALLE E-Mails eines Ordners per Scroll-Enumeration (überwindet die Virtualisierung der Nachrichtenliste). Gibt conversation-IDs + Vorschau je Mail zurück.

Inputs: folder (required), maxScrolls.

outlook_closeB

Schließt die Hintergrund-Browserinstanz.

Inputs: no named parameters.

outlook_create_draftA

Erstellt einen neuen E-Mail-Entwurf im Ordner "Entwürfe" (Drafts) in Outlook Web. Du musst die E-Mail danach nur noch in Outlook öffnen, kurz gegenlesen und absenden.

Inputs: to (required), body (required), subject (required), cc.

outlook_get_emailB

Liest eine E-Mail im Lesebereich vollständig aus (Markdown, Teams-Links, Metadaten). Standardmäßig die oberste E-Mail (Index 0).

Inputs: id, index.

outlook_list_foldersA

Listet die Ordner im Navigationsbereich (Inbox, Sent Items, Archive, Deleted Items, Drafts, Newsletter) mit ihren Namen und Item-Counts.

Inputs: no named parameters.

outlook_list_recentC

Listet die neuesten E-Mails im Posteingang auf.

Inputs: limit.

outlook_loginB

Öffnet ein sichtbares Browserfenster (Edge/Chromium via WSLg/Desktop), damit du dich einmalig bei Microsoft 365 / OWA anmelden kannst.

Inputs: realm.

outlook_navigate_folderC

Navigiert in einen Mail-Ordner (inbox|sentitems|archive|deleteditems|drafts|newsletter).

Inputs: folder (required).

outlook_read_emailB

Liest eine E-Mail vollständig im Lesebereich (Markdown) anhand ihrer conversation-ID (data-convid aus bulk_list). Scrollt ggf. automatisch durch den Ordner, bis die conversation gefunden ist.

Inputs: id (required), folder.

outlook_statusA

Prüft den Status der Outlook Web Verbindung und ob du eingeloggt bist.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 11 tools

    Disambiguation3/5

    outlook_get_email (reads top email by index) and outlook_read_email (reads by conversation-ID) have heavily overlapping purposes, and outlook_list_recent vs outlook_bulk_list both enumerate emails with only subtle differences. Descriptions clarify the intended workflow, but an agent could easily pick the wrong reader or lister.

    Naming Consistency4/5

    Consistent outlook_ prefix with mostly verb_noun naming (list_recent, get_email, create_draft, list_folders, navigate_folder, bulk_list). Minor deviation with bare verbs like status, login, and close, but overall readable and predictable.

    Tool Count5/5

    11 tools is well-scoped for an OWA automation server, covering session lifecycle (login/status/close) plus core mail operations without bloat. Each tool earns its place.

    Completeness3/5

    Covers listing, searching, reading, folder navigation, and draft creation, but the lifecycle dead-ends at drafts — no send, reply, forward, delete, or move operations. Agents cannot complete a full email workflow without leaving the tool set.

    Maintenance

    ActivityStale
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to interact with Microsoft Outlook via the Microsoft Graph API for managing emails and calendar events. It allows users to read and send emails, list messages, and create calendar appointments with automatic Teams links.
      1
      ISC
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to interact with Microsoft 365 Outlook Mail, allowing email operations via natural language.
      119 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to manage Microsoft Outlook emails through the Microsoft Graph API, supporting operations like listing, reading, sending, and moving emails.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to read, search, draft, send, reply to, forward, and organize Microsoft Outlook mail via Microsoft Graph, with safe-by-default read-only operation and browser-based sign-in.
      15
      71 npm
      MIT