Proton Mail MCP

Name: Proton Mail MCP
Author: Alexendros

von AlexendrosVersion 0.1.2i★ –iLäuft auf deinem Computer

Name in der Registryio.github.Alexendros/proton-mail-mcp

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

Proton Mail MCP via Bridge (IMAP/SMTP) · 13 tools · dual transport stdio + HTTP.

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
Unsere Basischecksi1 von 1 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
NutzungiGanz neu★ –

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

Verbindung: Läuft auf deinem Computer
Transport: stdio
Kategorie: Sonstiges
Das musst du eintragen: PROTON_USERNAME, PROTON_PASSWORD

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Bevor du installierst

Basischecks: 1 von 1 bestanden
Läuft auf deinem Computer mit den Rechten deines Benutzerkontos (Dateien, Netzwerk, Apps).
Das trägst du selbst ein: PROTON_BRIDGE_HOST, PROTON_IMAP_PORT, PROTON_SMTP_PORT, PROTON_USERNAME, PROTON_PASSWORD

Als geheim markierte Werte sind Schlüssel zu deinem Konto. Gib sie nie weiter und füge sie nie in einen Chat ein.

Du brauchst

npmNode.js installiert (für den Befehl npx)

Welche App nutzt du?

ClaudeClaude CodeCursorVS CodeChatGPT

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein

{
  "mcpServers": {
    "proton-mail": {
      "command": "npx",
      "args": [
        "-y",
        "@alexendros/proton-mail-mcp"
      ],
      "env": {
        "PROTON_BRIDGE_HOST": "your-value",
        "PROTON_IMAP_PORT": "your-value",
        "PROTON_SMTP_PORT": "your-value",
        "PROTON_USERNAME": "your-value",
        "PROTON_PASSWORD": "your-value"
      }
    }
  }
}

Führe das in deinem Terminal aus

claude mcp add proton-mail --env PROTON_BRIDGE_HOST=your-value --env PROTON_IMAP_PORT=your-value --env PROTON_SMTP_PORT=your-value --env PROTON_USERNAME=your-value --env PROTON_PASSWORD=your-value -- npx -y @alexendros/proton-mail-mcp

Trag die leeren Werte ein, bevor du ihn startest.

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

{
  "mcpServers": {
    "proton-mail": {
      "command": "npx",
      "args": [
        "-y",
        "@alexendros/proton-mail-mcp"
      ],
      "env": {
        "PROTON_BRIDGE_HOST": "your-value",
        "PROTON_IMAP_PORT": "your-value",
        "PROTON_SMTP_PORT": "your-value",
        "PROTON_USERNAME": "your-value",
        "PROTON_PASSWORD": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

{
  "servers": {
    "proton-mail": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@alexendros/proton-mail-mcp"
      ],
      "env": {
        "PROTON_BRIDGE_HOST": "your-value",
        "PROTON_IMAP_PORT": "your-value",
        "PROTON_SMTP_PORT": "your-value",
        "PROTON_USERNAME": "your-value",
        "PROTON_PASSWORD": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Werte, die du selbst einträgst

PROTON_BRIDGE_HOST env
Hostname or IP of the Proton Mail Bridge (default: 127.0.0.1 for local, or container hostname in compose).
PROTON_IMAP_PORT env
IMAP port exposed by Proton Mail Bridge (default: 1143).
PROTON_SMTP_PORT env
SMTP port exposed by Proton Mail Bridge (default: 1025).
PROTON_USERNAME erforderlich env
Bridge username (your Proton Mail address).
PROTON_PASSWORD geheim erforderlich env
Bridge-generated app password (NOT your Proton account password).

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 8. Nov. 2026

✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto Alexendros bestätigt, dem das Repo gehört
… Noch nicht geprüft
Wird noch gepflegt
Dieses Repo haben wir noch nicht von GitHub gelesen
… Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
– Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
– Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
… Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Im Vergleich mit anderen in Sonstigesi

Mehr Sterne als 0 % der anderen 18600 Server in dieser Kategorie
Neuer in der Registry veröffentlicht als 6 % der anderen 18600 Server in dieser Kategorie
Basischecks gleich gut wie oder besser als bei 100 % der anderen 18600 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Proton Mail MCP sicher?

Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: PROTON_USERNAME, PROTON_PASSWORD

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (0.1.2) kam vor 6 Monaten in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Spec Driven Development, Remote Desktop Commander, alalanet — check before you pay

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Spec Driven Development

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

von formulahendryAm Anfang↓ 66/Wo.★ 440Aktualisiert vor 14 Monaten

Läuft auf deinem Computer

Installieren

Remote Desktop Commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

von desktop-commanderWachsend★ 211Aktualisiert vor 3 Tagen

Läuft in der Cloud✓ desktopcommander.app

Installieren

alalanet — check before you pay

Check packages, MCP servers and x402 endpoints before agents install or pay. Signed.

von alalanetAm AnfangAktualisiert heute

Läuft in der Cloud✓ alalanet.com

Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

Proton Suite Agent

Propósito de este documento

Objetivos: Orientar el pulso del repo, el quickstart y el enrutado a los documentos canónicos.
Estructura: Ficha → pulso → mapa de lectura → instalación, tools, agente, calidad.
Contenido a integrar según contexto: Stack TypeScript/MCP, frontera Bridge, dry-run por defecto, Makefile fachada.

Abrir cuando: Orientación, pulso y enrutado. Aprobado: 15 de agosto de 2026 Audiencia: Agente, Dirección, Usuarios Autoridad: Lectura Clase: Obligatorio Días para revisión: 14 En repo: Sí Estado: Vigente Orden: 1 Propósito: Punto de entrada: pulso, quickstart y qué leer después. Reforma: Operativa Responsable: Alexendros Revisión: 29 de agosto de 2026 Rol: Entrada Ruta: ./README.md

📌

Propósito

Punto de entrada de lectura. Te dice el pulso, cómo arrancar y qué documento abrir después. Lo no negociable vive en CONSTITUTION.md.

Estado en una mirada

Pulso: 24 de septiembre de 2026 · v1.4.0

Fase activa: Fase 1 (Pass / agente / DX) checklist cerrada · siguiente: Fase 2 (Calendar, bloqueada). Ver ROADMAP.md.

Métricas: 47 tools por defecto (50 con Calendar experimental) · 965 tests · cobertura ~98% (gate 95%).

Capa	Estado
Mail (Bridge IMAP/SMTP)	Operativo
Pass (`pass` / `gopass`)	Operativo
Drive (`proton-drive` CLI)	Operativo (ADR-006)
Calendar	Stub hasta CalDAV en Bridge (ADR-005)
Documentación canónica	Subfase 0 completada

MCP server multi-producto para Proton Suite: Mail, Pass, Drive y Calendar (stub). Un agente opera el buzón, gestiona contraseñas y sincroniza archivos — local, sin exfiltrar contenido E2E.

Modo	Descripción
stdio (default)	Sin exponer red. Ideal para agentes IA locales.
streamable HTTP	Bearer auth + origin allowlist. Docker / reverse proxy.

Qué leer a continuación

Si necesitas	Abre	Aún no
Lo no negociable	CONSTITUTION.md	ROADMAP entero
Orden de trabajo y fases	ROADMAP.md	Código
Implementar como agente	AGENTS.md	ARCHITECTURE completo
Capas y flujos	ARCHITECTURE.md	Código
Threat model	SECURITY.md	—
Contribuir / PR	CONTRIBUTING.md	—
Contrato de tools MCP	docs/api/mcp-tools.md	—
Decisiones (por qué)	docs/adr/	—
Índice de guías	docs/README.md	—
Playbooks + prompts	playbooks/README.md	—

Primera sesión: este README → AGENTS.md §§ TL;DR + ficha → fase activa en ROADMAP.md → ADR/ancla citada.

Quickstart

Prerrequisitos: Node ≥ 22, pnpm, Proton Mail Bridge en local, pass o gopass + gpg para contraseñas.

1. Instalar y compilar

git clone https://github.com/Soluciones-Alexendros/protonsuite-tools.git

cd protonsuite-tools pnpm install && pnpm build && pnpm run smoke

2. Configurar variables de entorno

export PROTON_BRIDGE_USER=you@proton.me

export PROTON_BRIDGE_PASS=your-bridge-password export PROTON_MAIL_FROM=you@proton.me

3. Conectar tu cliente MCP

"mcpServers": { "protonsuite": { "command": "npx", "args": ["-y", "@alexendros/protonsuite-agent", "protonsuite-mcp"], "env": { "MCP_TRANSPORT": "stdio", "PROTON_BRIDGE_USER": "you@proton.me", "PROTON_BRIDGE_PASS": "your-bridge-password", "PROTON_MAIL_FROM": "you@proton.me", "PROTON_BRIDGE_TLS_INSECURE": "true", "PROTON_PASS_ENABLED": "true", }, }, }, }

Seguridad: usa PROTON_PASS_BRIDGE_PATH=proton/bridge/password o el wrapper JIT en connectors/stdio-wrapper.sh.example para no dejar el bridge password en disco.

4. Organizar el buzón (dry-run)

AGENT_DRY_RUN=true pnpm exec protonsuite-agent organize

o: npx -y @alexendros/protonsuite-agent organize

El agente analiza el inbox y presenta un plan sin aplicar cambios. Desactiva AGENT_DRY_RUN solo tras revisión.

Tools MCP

El inventario depende de qué productos estén habilitados: un producto apagado no registra ni anuncia sus herramientas.

Configuración	Tools
Por defecto (Mail + Drive)	39
+ Pass y Calendar (`PROTON_PASS_ENABLED=true`, `PROTON_CALENDAR_ENABLED=true`)	47
+ Calendar experimental (`PROTON_CALENDAR_EXPERIMENTAL=true`)	50
Todos los productos apagados	5 (solo `proton_suite_status` y `proton_ecosystem_*`)

Lectura: response_format: "markdown" | "json".

Producto	Tools	Resumen
Mail	14	List, search, read, send, reply, forward, flag, move, delete, attachments
Pass	4+	List, get (sin valores), generate, health; audit vía agente
Drive	8+	Status, list, download, upload, share, audit, organize
Calendar	stub	`{available: false}` hasta CalDAV vía Bridge (ADR-005)
Suite / Bridge / Ecosystem / Agent	resto	Estado unificado, Bridge, binarios, plan de agente

Contrato generado: docs/api/mcp-tools.md. Guía: docs/agent-quickstart.md.

Escribir requiere tu aprobación

Leer no pide nada. Escribir, borrar o tocar credenciales no se ejecuta: el servidor deja una solicitud y te la enseña.

protonsuite-agent pending          # qué espera aprobación, con los campos sensibles tachados

protonsuite-agent approve # lo autorizas protonsuite-agent reject # lo deniegas

Después de aprobar, repite exactamente la misma llamada. Si cambias un destinatario o una letra del cuerpo, la aprobación ya no vale y habrá que aprobar otra vez.

Aprobar solo se puede desde tu terminal: no hay forma de hacerlo por MCP ni pidiéndoselo al modelo. Detalles en ADR-0009.

Agente

Goal	Pipeline
`setup`	Verifica Bridge (IMAP + SMTP)
`organize`	Clasifica inbox, carpetas/etiquetas, amenazas
`monitor` / `alert`	Solo lectura — alertas
`pass-audit`	Fortaleza, duplicados y plan de rotación. Solo lectura: nunca escribe en el store.
`suite-status`	Reporte cross-producto
`discover` / `check-imap`	Conectividad
Drive goals	`drive-audit`, `drive-organize`, …

Drive CLI

sudo wget -q 'https://proton.me/download/drive/cli/linux/proton-drive' \

-O /usr/local/bin/proton-drive && sudo chmod +x /usr/local/bin/proton-drive proton-drive auth login

Requiere DRIVE_ENABLED=true (default). Ver docs/drive-audit.md.

Despliegue

docker compose up -d

Ver docs/deployment-http-docker.md. Instalador: scripts/install.sh.

Interfaz local

SPA estática en apps/web (ADR-0007): landing y panel de estado. No forma parte del proceso MCP. pnpm run build la genera en apps/web/dist. Se abre sin Bridge; el panel usa el adaptador local «datos de ejemplo» y no pide credenciales. Calendar sigue en stub.

Documentación

Documento	Para quién	Qué cubre
`CONSTITUTION.md`	Todos	No negociables
`ROADMAP.md`	Dirección / agente	Fases y criterios de salida
`AGENTS.md`	Agentes IA	Contrato operativo
`docs/human-quickstart.md`	Usuarios	Instalación paso a paso
`docs/agent-quickstart.md`	Agentes IA	Tools y ejemplos
`docs/bridge-core.md`	Operadores	Bridge headless
`docs/deployment-http-docker.md`	DevOps	Docker, auth, Pass en compose
`docs/local-stdio-secrets.md`	Operadores	Wrapper JIT
`docs/alerting.md`	Operadores	Webhook, ntfy, logs
`docs/drive-audit.md`	Operadores	Drive CLI
`ARCHITECTURE.md`	Desarrolladores	Capas y flujos
`SECURITY.md`	Auditores	Threat model
`CONTRIBUTING.md`	Contribuidores	PRs, pnpm, tests
`SUPPORT.md`	Usuarios	Canales de ayuda
`CODE_OF_CONDUCT.md`	Comunidad	Conducta
`docs/`	Todos	architecture / guides / runbooks
`playbooks/`	Operadores	Workflows + prompts

Calidad

Fachada canónica (Makefile): make lint, make test, make smoke, make validate.

make validate        # lint + typecheck + test + build + smoke

pnpm run typecheck # TypeScript strict pnpm test # Vitest (953+) pnpm run coverage # Coverage v8 — gate 95%, objetivo ≥98% pnpm run build # tsc → dist/ y SPA apps/web (tokens, contraste, vite) pnpm run smoke # stdio initialize + tools/list pnpm run knip # Unused deps/exports pnpm docs:check # mcp-tools.md en sync

Seguridad (resumen)

Bearer timing-safe, origin allowlist, rate-limit 120/min/token.
HTTP per-session; idle eviction 30 min.
Pass nunca expone valores — solo {found: true}.
Dry-run por defecto en el agente (CONSTITUTION.md §4).

Progreso de cobertura

Fecha	Statements	Branches	Tests	Notas
Ago 2026	~98%	~95%	953	Subfase 0 + Fase 1
Jul 2026	98.07%	93.63%	864	Branch hunt
Jun 2026	61.7%	—	258	Base

*Conteo canónico: pnpm test 2>&1 | grep -E 'Test Files|Tests'.*

Licencia

Ver NOTICE.md para dependencias.

Proton Mail MCP

Überblick

Die drei Säulen von PopNx MCP

Was du damit machen kannst

Installation

Bevor du installierst

Werte, die du selbst einträgst

Was er kann

Basischecksi

Entwickler passt zum Repo

Wird noch gepflegt

Hat eine Lizenz

Endpunkt antwortet

Anmeldung mit OAuth

Keine versteckten Anweisungen in Tool-Beschreibungen

Im Vergleich mit anderen in Sonstigesi

Häufige Fragen

Alternativen

Spec Driven Development

Remote Desktop Commander

alalanet — check before you pay

README vom Entwickler

Proton Suite Agent

Propósito de este documento

Estado en una mirada

Qué leer a continuación

Quickstart

1. Instalar y compilar

2. Configurar variables de entorno

3. Conectar tu cliente MCP

4. Organizar el buzón (dry-run)

o: npx -y @alexendros/protonsuite-agent organize

Tools MCP

Escribir requiere tu aprobación

Agente

Drive CLI

Despliegue

Interfaz local

Documentación

Calidad

Seguridad (resumen)

Progreso de cobertura

Licencia