How do I install Proton Mail?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Proton Mail need an API key?

The publisher lists these environment variables: PROTON_BRIDGE_HOST, PROTON_IMAP_PORT, PROTON_SMTP_PORT, PROTON_USERNAME, PROTON_PASSWORD.

What transport does Proton Mail use?

Proton Mail runs locally over stdio.

When was Proton Mail last checked?

Last checked 2026-11-08. Proton Mail MCP via Bridge (IMAP/SMTP) · 13 tools · dual transport stdio + HTTP.

Proton Mail MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @alexendros/[email protected]

Credentials from the publisher

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

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1PROTON_BRIDGE_HOST=<value> PROTON_IMAP_PORT=<value> PROTON_SMTP_PORT=<value> PROTON_USERNAME=<value> PROTON_PASSWORD=<secret> claude mcp add io.github.alexendros-proton-mail-mcp -- npx -y @alexendros/proton-mail-mcp@0.1.2

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.alexendros-proton-mail-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "@alexendros/[email protected]"8      ],9      "env": {10        "PROTON_BRIDGE_HOST": "<value>",11        "PROTON_IMAP_PORT": "<value>",12        "PROTON_SMTP_PORT": "<value>",13        "PROTON_USERNAME": "<value>",14        "PROTON_PASSWORD": "<secret>"15      }16    }17  }18}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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 [email protected]
export PROTON_BRIDGE_PASS=your-bridge-password
export [email protected]

3. Conectar tu cliente MCP

{
  "mcpServers": {
    "protonsuite": {
      "command": "npx",
      "args": ["-y", "@alexendros/protonsuite-agent", "protonsuite-mcp"],
      "env": {
        "MCP_TRANSPORT": "stdio",
        "PROTON_BRIDGE_USER": "[email protected]",
        "PROTON_BRIDGE_PASS": "your-bridge-password",
        "PROTON_MAIL_FROM": "[email protected]",
        "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 <id>     # lo autorizas
protonsuite-agent reject <id>      # 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

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.

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Proton Mail?

Does Proton Mail need an API key?

What transport does Proton Mail use?

When was Proton Mail last checked?

Documentation

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)

Tools MCP

Escribir requiere tu aprobación

Agente

Drive CLI

Despliegue

Interfaz local

Documentación

Calidad

Seguridad (resumen)

Progreso de cobertura

Licencia