Proton Mail MCP
Servidor MCP (Model Context Protocol) para Proton Mail vía Proton Mail Bridge. Expone la bandeja — lectura, búsqueda, envío, mover, etiquetar, borrar — a cualquier cliente MCP con tipado estricto, anotaciones de seguridad y doble transporte (stdio y streamable HTTP).
Se instala de dos formas: como plugin de Claude Code (un comando, sin tocar dist/; ver Instalación como plugin) o como servidor MCP autohospedado (clon + build, o despliegue HTTP avanzado). El repo incluye además una skill de triaje de correo (ver Skill de triaje) que clasifica el INBOX y aparta la basura comercial sin borrar nada.
La garantía E2E de Proton se preserva: el cifrado y descifrado ocurren en Bridge, una máquina que controlas tú. Ni los servidores de Anthropic ni terceros ven tu correo descifrado — sólo el agente al que tú autorizas.
Modo de uso de referencia: local, stdio, on-demand. El camino primario es el cliente local (Claude Code lanza el MCP por stdio cuando lo necesita, contra un Bridge en 127.0.0.1). El despliegue HTTP/Docker existe y está documentado como modo avanzado en docs/deployment-http-docker.md, pero no es necesario para el uso normal.
Por qué existe este proyecto
Hay dos formas comunes de darle "ojos sobre el correo" a un asistente como Claude:
- Copiar y pegar bloques de correo dentro del chat. Trabajoso, frágil y sin trazabilidad.
- OAuth contra un proveedor SaaS (Gmail API, Microsoft Graph). Funciona pero expone los datos al proveedor y deja el agente fuera de una cuenta Proton Mail, que es E2E y no tiene API pública.
Este MCP resuelve ambos problemas sobre Proton Mail:
- Interfaz MCP estándar. Cualquier cliente compatible (Claude Code CLI, Claude Routines, SDK cliente en tu backend) puede llamar a las 13 tools sin implementar IMAP/SMTP.
- Autohospedado. El binario corre donde tú decidas — laptop, VPS, contenedor. Bridge hace la criptografía en el mismo host y nunca expone el vault a la red pública.
- Dual transport.
stdio para cliente local (Claude Code en la CLI), streamable HTTP con bearer auth + allowlist de origen para clientes remotos (Routines, dashboards propios).
Este repositorio también sirve como muestra pública de craft: tests automatizados, hardening por capas, CI/CD completo y modelo de amenazas explícito — no es un boilerplate, es una pieza de producción.
Estado actual
