outlook-bridge

MCP-Server, mit dem Claude E-Mails in Outlook classic (Windows, über COM) suchen und lesen kann — list_folders, search_mail, read_mail, get_thread, read_attachment. Das vollständige Design findest du unter docs/superpowers/specs/2026-08-24-outlook-bridge-design.md und den Implementierungsplan unter docs/superpowers/plans/2026-08-24-outlook-bridge-a.md.

Nur lesen — keine Schreib-Tools

Dieser Server hat keine send_mail-, delete_mail-, move_mail-, mark_as_read- oder sonstige Tools, die E-Mails ändern, löschen oder senden. Keine Methode in Win32MailStore ruft .Send(), .Save(), .Delete(), .Move(), .MarkAsRead() auf oder weist einer Outlook-Eigenschaft einen Wert zu. Einzige Ausnahme: read_attachment schreibt Anhänge in ein temporäres Verzeichnis, das der Server selbst erstellt (tempfile.TemporaryDirectory), um Text zu extrahieren, und löscht dieses Verzeichnis danach sofort wieder — SaveAsFile ist eine Lese-API und ändert nichts in Outlook.

Related MCP server: outlook-mcp

Ausführung unter Linux (Entwicklungsrechner) — FakeMailStore

Kein Outlook, kein Windows nötig. FakeMailStore lädt eine YAML-Fixture (~50 synthetische E-Mails: mehrere Ordner, mehrere Stores, Konversationsthreads, Anhänge aller Art, vietnamesische E-Mails, lange E-Mail-Bodies, leere E-Mails, Nicht-E-Mail-Elemente) und implementiert dieselbe MailStore-Schnittstelle, die auch Win32MailStore implementiert.

python -m venv .venv
.venv/bin/pip install -e ".[dev]"

# Chạy server với store giả (không cần Outlook)
OUTLOOK_BRIDGE_FAKE=1 OUTLOOK_BRIDGE_FIXTURE=tests/fixtures/mailbox.yaml \
  .venv/bin/python server.py

Tests ausführen

Linux (der Großteil der Logik — reines Python + FakeMailStore):

.venv/bin/pytest

Windows (der Contract-Test-Satz, der für BEIDE Stores gemeinsam verwendet wird — das ist der einzige Weg nachzuweisen, dass Win32MailStore sich tatsächlich wie FakeMailStore verhält, nicht nur „läuft"):

set OUTLOOK_BRIDGE_CONTRACT_WIN32=1
.venv\Scripts\pytest tests/contract -v

Einige Fälle in diesem Satz sind auf einem echten Postfach bewusst SKIP (Daten gibt es nur in der Fixture von FakeMailStore) — lies den Abschnitt „Test SKIP có chủ đích" in docs/WINDOWS-RUNBOOK.md, bevor du einen SKIP als Anzeichen für ein Problem betrachtest.

Siehe docs/INSTALL-windows.md für Installation und Registrierung des MCP-Servers unter Windows und docs/WINDOWS-RUNBOOK.md für die Vorgehensweise, wenn du zum ersten Mal vor einem echten Windows-Rechner sitzt.

Umgebungsdiagnose — doctor.py

python doctor.py            # trên Linux: báo "không phải Windows", degrade an toàn
python doctor.py --verbose  # trên Windows: thêm chi tiết root.Name, cây folder, giá trị raw

Zwei Risiken, die noch niemand gelöst hat (Spec §13)

R2 — New Outlook wird Outlook classic nach und nach ersetzen, und COM verschwindet damit. Microsoft migriert Nutzer zwangsweise zu New Outlook, das keinen COM-Server registriert (doctor.py meldet com_ok: False, sobald das passiert). Das ist ein Ablaufdatum, kein behebbarer Fehler. Der einzige Ausweg, wenn es so weit ist, ist ein Neuschreiben von Win32MailStore auf Basis der Microsoft Graph API — die Architektur des Projekts (sämtliche COM-Details liegen nur in genau zwei Dateien, win32_store.py und doctor.py) begrenzt den Schaden auf das Neuschreiben genau dieser zwei Dateien, nicht des gesamten Systems.

R3 — Interne Firmen-E-Mail-Inhalte laufen über die API von Anthropic. COM läuft vollständig lokal (nichts verlässt den Rechner, um E-Mails zu lesen), aber damit Claude auf Basis der E-Mail-Inhalte antworten kann, müssen diese Inhalte an die API gesendet werden. Das ist der inhärente Kompromiss bei der Nutzung eines KI-Assistenten zum E-Mail-Lesen — kein Server kann das für dich lösen.

Einzige Kontrollmaßnahme: folder_allowlist in config.toml. Setze sie auf eine Liste konkreter Ordner (store-qualifiziert, z. B. "Mailbox - Nguyen Van A/Inbox"), um den Bereich der E-Mails zu begrenzen, die dieser Server sehen kann — E-Mails außerhalb der Allowlist können von keinem Tool gelesen werden, über keinen Aufrufpfad (Suche, Lesen per ID, Thread lesen, Anhänge herunterladen), auch wenn ein Konversationsthread die Allowlist-Grenze überschreitet.

Der Abgleich ist EXAKT, nicht präfixbasiert. Die Erlaubnis für "Inbox" zieht "Inbox/Bao cao" NICHT mit ein — jeder Ordner, der erlaubt sein soll, muss einzeln aufgeführt werden. Das ist eine bewusste Designentscheidung, keine Einschränkung: Eine präfixbasierte Allowlist kann leicht versehentlich einen sensiblen Unterordner durchlassen, an den der Konfigurierende nicht gedacht hat. Wenn folder_allowlist nicht konfiguriert ist (Standard: leere Liste), sind alle Ordner im Postfach lesbar — konfiguriere sie, bevor du diesen Server auf ein echtes Firmenpostfach richtest. Siehe docs/WINDOWS-RUNBOOK.md Schritt 2, um die korrekten store-qualifizierten Ordnernamen von list_folders zu erhalten.

Falls du es noch enger ziehen willst: Verkleinere folder_allowlist auf ein paar konkrete Ordner, oder — falls das immer noch nicht reicht — erwäge, nur Metadaten + Snippet statt des vollständigen E-Mail-Inhalts zurückzugeben (dafür gibt es derzeit noch kein Tool; es wäre ein neues Tool nötig).