@darkroomhq/protonmail-mcp

MCP-Server, der KI-Assistenten vollen Zugriff auf Ihr ProtonMail-Konto über die Proton Bridge gewährt. Lesen, senden, suchen und verwalten Sie E-Mails über jeden MCP-kompatiblen Client.

Voraussetzungen

• Proton Bridge lokal installiert und angemeldet

• Node.js 18+

Related MCP server: Proton Mail MCP Server

Installation

npm install -g @darkroomhq/protonmail-mcp

Oder ohne Installation verwenden:

npx @darkroomhq/protonmail-mcp

Konfiguration

Fügen Sie dies zu Ihrer MCP-Client-Konfiguration hinzu (z. B. claude_desktop_config.json):

{
  "mcpServers": {
    "protonmail": {
      "command": "protonmail-mcp",
      "env": {
        "PROTONMAIL_USERNAME": "your@protonmail.com",
        "PROTONMAIL_PASSWORD": "bridge-app-password"
      }
    }
  }
}

Mit npx (keine globale Installation erforderlich):

{
  "mcpServers": {
    "protonmail": {
      "command": "npx",
      "args": ["-y", "@darkroomhq/protonmail-mcp"],
      "env": {
        "PROTONMAIL_USERNAME": "your@protonmail.com",
        "PROTONMAIL_PASSWORD": "bridge-app-password"
      }
    }
  }
}

Hinweis: PROTONMAIL_PASSWORD ist das Bridge-App-Passwort, das in der Proton Bridge angezeigt wird, nicht Ihr ProtonMail-Kontopasswort.

Alle Umgebungsvariablen

Tools

Beispiel-Prompts

Lesen & Zusammenfassen

• "Fasse meine ungelesenen E-Mails von dieser Woche zusammen."

• "Lies die letzte E-Mail von Alice und sag mir, worum sie bittet."

Suchen

• "Finde alle E-Mails zum Q2-Bericht aus den letzten 30 Tagen."

• "Suche nach markierten E-Mails in meinem Ordner 'Gesendet'."

Senden & Antworten

• "Sende eine E-Mail an Bob und teile ihm mit, dass das Meeting auf Donnerstag um 15 Uhr verschoben wurde."

• "Antworte auf die letzte E-Mail des Design-Teams und frage nach den aktualisierten Mockups."

Massenoperationen

• "Lösche alle E-Mails von IGN in meinem Posteingang."

• "Markiere alle ungelesenen Newsletter als gelesen."

• "Verschiebe alle E-Mails von noreply@github.com in den GitHub-Ordner."

• "Wie viele markierte E-Mails habe ich aus dem letzten Monat?" (verwendet Testlauf)

Organisieren

• "Verschiebe alle Newsletter aus meinem Posteingang in den Ordner 'Newsletter'."

• "Markiere die drei neuesten E-Mails von meinem Manager."

• "Lösche alle E-Mails im Spam-Ordner."

• "Erstelle einen Ordner namens 'Belege' und verschiebe alle Kaufbestätigungen dorthin."

• "Erstelle ein Label namens 'Dringend' für E-Mails, die sofortige Aufmerksamkeit erfordern."

• "Benenne den Ordner 'Alte Projekte' in 'Archiv' um."

Status

• "Prüfe, ob die Proton Bridge verbunden ist."

Leistungstipps

• Cursor-Paginierung: Verwenden Sie beforeUid (zurückgegeben als nextCursor) anstelle von page für eine stabile Paginierung, die nicht durch neue E-Mails beeinflusst wird, die zwischen den Anfragen eingehen.

• Nur Header: Verwenden Sie headersOnly: true bei readEmail, um das Herunterladen des vollständigen Nachrichtentextes zu überspringen – nützlich, wenn Sie nur Metadaten benötigen.

• Textkürzung: Verwenden Sie maxBodyLength bei readEmail, um die Textgröße zu begrenzen (z. B. 2000 Zeichen) und große Antworten bei E-Mails mit viel Inhalt zu vermeiden.

• Massenaktionen: Verwenden Sie bulkAction mit Suchkriterien (criteria) anstelle von Schleifen über einzelne E-Mails. Dies führt einen einzigen IMAP-SEARCH + einen einzigen Massenbefehl aus, unabhängig davon, wie viele E-Mails übereinstimmen.

• Testlauf: bulkAction ist standardmäßig auf dryRun: true eingestellt – sehen Sie sich die betroffenen E-Mails an, bevor Sie destruktive Operationen ausführen.

Entwicklung

npm install
npm run build   # compile TypeScript
npm run dev     # watch mode