outlook-classic-windows-mcp

MVP-MCP-Server für die Arbeit mit einem lokal konfigurierten klassischen Outlook für Windows-Desktopprofil.

Dieser verwendet nicht Microsoft Graph, Outlook im Web, das neue Outlook für Windows oder von Administratoren aktivierte Cloud-APIs. Er nutzt Windows-COM-Automatisierung gegen das klassische Outlook-Desktopprogramm/-profil, das auf dem Rechner verfügbar ist, auf dem der MCP-Server läuft. Das ist nützlich, wenn du dich nicht mit deinem IT-Support herumschlagen oder deinen Administrator um Erlaubnis bitten möchtest.

Hinweis: Dieser MCP ist speziell auf meinen eigenen Workflow und meine Anforderungen zugeschnitten. Es wird empfohlen, ihn zu forken und anzupassen – oder deinen Coding-Agenten darum zu bitten –, um den MCP an deine eigene Outlook-Umgebung und deinen Anwendungsfall anzupassen.

Warnung: Das klassische Outlook für Windows wird für Microsoft-365-Benutzer mindestens bis 2029 unterstützt. Das neue Outlook wird nach und nach zum Standard oder zur Ablösung. Dieser MCP wird nur kurz- bis mittelfristig nutzbar sein. Langfristig solltest du einen anderen MCP verwenden, der auf Administrator-APIs basiert! Siehe https://learn.microsoft.com/en-us/answers/questions/5554339/when-will-classic-outlook-end

Anforderungen

• Windows

• Klassisches Microsoft Outlook-Desktopprogramm installiert und konfiguriert

• uv

Installation / Ausführung

cd C:\Users\muhammad.menjeni\git\outlook-classic-windows-mcp
uv sync
uv run outlook-local-mcp

Der MCP-Server spricht stdio und ist daher dafür gedacht, von einem MCP-Client gestartet zu werden.

Pi-MCP-Konfigurationsbeispiel

Füge einen lokalen Servereintrag ähnlich wie diesen in deine Pi-MCP-Konfiguration ein und passe den Pfad bei Bedarf an:

{
  "mcpServers": {
    "outlook-local": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\Users\\muhammad.menjeni\\git\\outlook-classic-windows-mcp",
        "run",
        "outlook-local-mcp"
      ]
    }
  }
}

Werkzeuge

search_email

Durchsucht Outlook-E-Mails nach Betreff und/oder Textkörper.

Argumente:

• query string: Groß-/Kleinschreibung ignorierende Teilzeichenkette zum Suchen.

• folder string: Zu durchsuchender Ordner. Standard: Inbox. Du kannst Pfade wie Inbox/Archive oder Mailbox Name/Inbox verwenden.

• search_scope: all, subject oder body. Standard: all.

• max_results: Anzahl der zurückzugebenden Treffer. Standard: 10.

• max_items: Neueste Elemente, die im Ordner überprüft werden sollen. Standard: 500.

• include_body_preview: Kurze Vorschau des Textkörpers einfügen. Standard: true.

list_mail_folders

Listet verfügbare Outlook-Ordner auf, um bei der Auswahl eines Ordnerpfads zu helfen.

create_leave_calendar_blocks

Erstellt zwei ungesendete Outlook-Kalendereinträge zur Abwesenheitsprüfung:

1. Einen persönlichen Blocker, der als Out of Office markiert ist, ohne Teilnehmer.

2. Eine Benachrichtigungsbesprechung, die als Frei markiert ist, mit den angegebenen Teilnehmern.

Es wird nichts gesendet. Standardmäßig werden beide Einträge gespeichert und in Outlook zur manuellen Überprüfung/ zum Senden geöffnet.

Argumente:

• start_time string: Startdatum/-zeit, z. B. 2026-09-01 08:00.

• end_time string: Enddatum/-zeit. Bei ganztägigen Ereignissen wird dies als exklusives Ende interpretiert, z. B. einen Tag von 2026-09-04 00:00 bis 2026-09-05 00:00.

• required_attendees list/string: Zusätzliche Benachrichtigungsempfänger. Konfigurierbare Standardwerte können ebenfalls verwendet werden.

• subject string: Standard aus der Konfiguration, anfänglich Amirul: On-Leave.

• body string: Nachrichtentext.

• optional_attendees list/string: Optionale Benachrichtigungsempfänger.

• location string.

• display boolean: Die gespeicherten Einträge in Outlook öffnen. Standard: true.

• confirmed boolean: Muss true sein, um tatsächlich Outlook-Kalendereinträge zu erstellen. Ohne Bestätigung gibt das Werkzeug nur einen Vorschlag zurück.

get_leave_defaults

Zeigt die aktuellen Abwesenheitsstandards und den Konfigurationspfad an.

set_leave_defaults

Speichert Abwesenheitsstandards wie Betreff und Benachrichtigungsempfänger. Erfordert confirmed=true, bevor die Konfiguration geschrieben wird.

infer_leave_recipients

Schreibgeschützter Scan aktueller lokaler Outlook-E-Mails, um Kandidaten für Verteilerlisten für Abwesenheitsbenachrichtigungen abzuleiten. Gibt Kandidaten und Belege zurück; es schreibt keine Konfiguration und erstellt keine Entwürfe.

resolve_recipients

Löst Namen, E-Mail-Adressen oder Verteilerlisten mithilfe der Outlook-Empfängerauflösung/des Adressbuchs auf.

search_contacts

Durchsucht lokale Outlook-Kontaktordner nach Name, E-Mail, Firma, Abteilung oder Berufsbezeichnung.

Hinweise / Einschränkungen

• Beim ersten Zugriff kann Outlook gestartet werden, falls es nicht bereits läuft.

• Deine Organisation kann Outlook-Objektmodell-Schutzaufforderungen anzeigen oder Automatisierung per Richtlinie blockieren.

• Dieser MVP sucht, indem er aktuelle Ordnerelemente scannt, was einfach und zuverlässig, aber nicht so schnell wie die indizierte Outlook-Suche für sehr große Ordner ist.