Proton Mail MCP

Name: Proton Mail MCP
Author: Alexendros

作者：Alexendrosバージョン 0.1.2i★ –iパソコンで動く

レジストリ名io.github.Alexendros/proton-mail-mcp

インストール

概要

作者による説明（英語の原文）

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

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
利用状況iとても新しい★ –

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

接続方法: パソコンで動く
トランスポート: stdio
カテゴリ: その他
入力が必要なもの：PROTON_USERNAME, PROTON_PASSWORD

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

基本チェック：1項目中1項目に合格
あなたのパソコンで、あなたのユーザーと同じ権限（ファイル、ネットワーク、アプリ）で動きます。
自分で入力するもの： PROTON_BRIDGE_HOST, PROTON_IMAP_PORT, PROTON_SMTP_PORT, PROTON_USERNAME, PROTON_PASSWORD

「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。

必要なもの

npmNode.jsのインストール（npxコマンドに必要）

どのアプリを使っていますか？

ClaudeClaude CodeCursorVS CodeChatGPT

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます

{
  "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"
      }
    }
  }
}

ターミナルでこれを実行します

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

動かす前に、空欄の値を入力してください。

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

{
  "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"
      }
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "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"
      }
    }
  }
}

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

自分で入力する値

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 必須 env
Bridge username (your Proton Mail address).
PROTON_PASSWORD 秘密必須 env
Bridge-generated app password (NOT your Proton account password).

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月10日にチェック

✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント Alexendros で確認済みです
… 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
… 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
– 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
– 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
… 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

その他のほかのサーバーとの比較i

このカテゴリのほかの19001件のうち0%よりスターが多い
このカテゴリのほかの19001件のうち6%より最近レジストリに公開
基本チェックの結果が、このカテゴリのほかの19001件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Proton Mail MCPは安全ですか？

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

入力が必要なもの：PROTON_USERNAME, PROTON_PASSWORD

パソコンで動きますか、それともクラウドですか？

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は–、最新バージョン（0.1.2）がレジストリに届いたのは6 か月前です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは？

同じカテゴリには：Spec Driven Development, Remote Desktop Commander, paidfor

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方：↓ 週あたりのダウンロードi★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i

Spec Driven Development

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

作者：formulahendry初期↓ 66/週★ 44014 か月前更新

パソコンで動く

インストール

Remote Desktop Commander

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

作者：desktop-commander成長中★ 211今日更新

クラウドで動く✓ desktopcommander.app

インストール

paidfor

Check an x402 seller before paying: verdict, failure rate and evidence from paid calls on Base.

作者：sarmadahsan初期↓ 231/週今日更新

パソコンでもクラウドでも✓ paidfor.dev

インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

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

概要

PopNx MCPの3つの柱

できること

インストール

インストールの前に

自分で入力する値

できること

基本チェックi

作者とリポジトリが一致

今もメンテナンスされている

ライセンスがある

エンドポイントが応答する

OAuthでサインイン

ツールの説明に隠れた指示がない

その他のほかのサーバーとの比較i

よくある質問

代わりの候補

Spec Driven Development

Remote Desktop Commander

paidfor

作者のREADME

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