Skip to main content
Glama
protonmail-mcp

protonmail-mcp

by apexxapps

protonmail-mcp

AI 코딩 에이전트가 ProtonMail에 액세스하여 검색, 읽기, 초안 작성, 전송을 할 수 있게 하세요 — Claude Code, Claude Desktop, Cursor 또는 모든 MCP 클라이언트에서.

"내 Proton을 확인하고 오늘 처리해야 할 일을 알려줘." "Sarah의 마지막 이메일을 찾아 목요일 오후 2시가 된다고 답장 초안을 작성해 — 아직 보내지는 마."

Proton은 종단간 암호화되어 있기 때문에 공개 메일 API가 없습니다 — 그래서 이것은 Proton Bridge와 통신합니다. Proton이 정확히 이를 위해 제공하는 공식 로컬 게이트웨이입니다. 모든 것은 127.0.0.1에 머물러 있습니다; 복호화된 메일은 절대 기기를 떠나지 않으며, 여기에는 호스팅 서비스가 없습니다.


시작하기 전에 — 단 하나의 요구 사항

같은 머신에서 Proton Bridge 가 실행 중이어야 합니다.

  • Bridge는 유료 Proton 플랜 (Mail Plus / Proton Unlimited)이 필요합니다. 무료 Proton 계정은 Bridge를 사용할 수 없으므로 이 도구를 사용할 수 없습니다. 이는 Proton의 제한 사항이지 우리의 제한 사항이 아닙니다.

  • Bridge는 macOS, Windows, Linux에서 실행됩니다 (서버에서는 protonmail-bridge --cli로 헤드리스 실행).

  • Bridge는 각 계정에 자체 생성된 IMAP/SMTP 사용자 이름 및 비밀번호를 제공합니다 — 여기서는 그것들을 사용하며, 일반 Proton 로그인이 아닙니다.

Related MCP server: ProtonMail MCP Server

설치

# Claude Code — one line, no global install:
claude mcp add protonmail --scope user -- npx -y protonmail-mcp

그런 다음 Bridge에 연결하는 방법을 알려주세요 — 환경 변수 또는 구성 파일을 통해.

구성 파일 (~/.config/protonmail-mcp/config.json):

{
  "user": "you@proton.me",
  "pass": "your-bridge-generated-password",
  "imapPort": 1143,
  "smtpPort": 1025
}

또는 환경 변수: PROTONMAIL_USER, PROTONMAIL_PASS, PROTONMAIL_IMAP_PORT, PROTONMAIL_SMTP_PORT. (전체 옵션은 config.example.json을 복사하세요.)

에이전트에 연결하기 전에 작동하는지 확인하세요:

npx protonmail-mcp doctor

그것은 Bridge에 연결하고 인증하며 메일함을 나열합니다 — 따라서 설정 문제가 있으면 명확한 메시지로 여기에 표시되어 대화 중에 알 수 없는 오류로 실패하는 일이 없습니다.

기타 MCP 클라이언트

모든 MCP 클라이언트가 작동합니다 — stdio를 통해 protonmail-mcp 명령을 가리키면 됩니다. JSON 구성 클라이언트 (Claude Desktop, Cursor, …)의 경우:

{
  "mcpServers": {
    "protonmail": {
      "command": "npx",
      "args": ["-y", "protonmail-mcp"],
      "env": { "PROTONMAIL_USER": "you@proton.me", "PROTONMAIL_PASS": "…" }
    }
  }
}

도구

읽기 (안전 — 에이전트가 자유롭게 실행하게 하세요):

도구

기능

list_mailboxes

폴더/라벨 나열

list_recent_mail

메일함의 최신 메시지 (요약)

get_unread_mail

읽지 않은 메시지 (요약)

search_mail

텍스트 / 보낸사람 / 받는사람 / 제목 / 날짜 범위로 검색

get_message

uid로 전체 메시지 (인용된 이력은 기본적으로 잘림)

쓰기 (MCP 클라이언트가 실행 전에 확인해야 함):

도구

기능

create_draft

초안 저장 (보내지 않음)

reply_to_message

스레드 답장 — 기본적으로 초안 저장, send=true일 때 전송

send_message

새 이메일 즉시 전송

mark_read / mark_unread

읽음 플래그 전환

archive_message / move_message

폴더 간 이동

trash_message

휴지통으로 이동 (비우기 전까지 되돌릴 수 있음)

"readOnly": true(또는 PROTONMAIL_READONLY=1)로 설정하면 읽기 전용 도구만 등록됩니다 — 에이전트가 클라이언트 승인 설정과 관계없이 보내기, 이동 또는 삭제를 절대 할 수 없는 확실한 보장입니다.

안전 모델

중요한 쓰기 도구 — send_message, trash_message, 그리고 send=true가 포함된 reply_to_message — 는 이름과 설명이 명확하여 MCP 클라이언트의 도구별 승인이 자연스러운 관문이 됩니다; 읽기는 절대 프롬프트를 띄우지 않습니다. 보내기보다 초안 작성을 선호하세요: 에이전트가 작성하고, Proton에서 검토하고, 보내기를 누릅니다. 무인/헤드리스 설정에서는 readOnly로 실행하면 승인할 위험한 것이 없습니다.

휴대폰에서

이것은 로컬 서버이므로 에이전트가 있는 곳이면 어디에서든 접근할 수 있습니다. 머신을 **BrainBoxx**와 페어링하면 주머니에서 모든 것을 할 수 있습니다 — 기차에서 "내 Proton을 확인하고 처리할 일을 알려줘", 집에 도착할 때쯤에는 답장 초안이 작성되어 있습니다.

작동 방식

MCP client (Claude Code / Cursor / …)
        │  MCP over stdio
        ▼
   protonmail-mcp   ──IMAP──►  127.0.0.1:1143  ┐
        │          ──SMTP──►  127.0.0.1:1025  ├─ Proton Bridge ──► Proton Mail
        └── clean JSON in, tool calls out       ┘   (local, TLS, your machine only)

Bridge는 localhost에서 자체 서명 인증서를 제공합니다 (예상됨); 기본적으로 127.0.0.1에 대해 이를 신뢰합니다. Bridge에 신뢰할 수 있는 인증서를 제공한 경우 "allowSelfSigned": false로 설정하여 전체 검증을 적용하세요.

라이선스

MIT © 2026 Simon Stark. Proton AG와 관련이 없으며 Proton AG의 보증을 받지 않습니다.

Available Tools

8 tools
create_draftA

Compose a new email and save it to Drafts. Does NOT send — you review and send it yourself in Proton. Can include local file attachments.

Inputs: to (required), subject (required), cc, bcc, +3 more.

download_attachmentA

Save an attachment from a message to disk (into the configured download directory). Identify it by filename or 0-based index (from get_message); if the message has just one attachment, neither is needed. Returns the saved file path.

Inputs: uid (required), index, mailbox, filename.

forwardA

Forward a message to new recipients, carrying its original attachments. Optional intro note via body. Sends immediately unless draft=true. Can add further local file attachments.

Inputs: to (required), uid (required), body, html, +3 more.

get_messageA

Read one full message by uid (from a search result). Quoted reply history and signatures are trimmed by default for readability; pass full=true to keep everything. The result lists any attachments (name/type/size) — use download_attachment to save one.

Inputs: uid (required), full, mailbox.

replyA

Reply to a message (to its sender), correctly threaded, quoting the original. Sends immediately unless draft=true (saves to Drafts for you to review). Can include local file attachments.

Inputs: uid (required), body, html, draft, +2 more.

reply_allA

Reply to a message and everyone on it (sender + all other recipients, excluding you), threaded and quoting the original. Sends immediately unless draft=true. Can include local file attachments.

Inputs: uid (required), body, html, draft, +2 more.

search_mailA

Search email by any combination of free-text, sender, recipient, subject, and date range. With NO filters it returns your most recent inbox messages. Returns summaries (no body) newest first — use get_message with a result's uid to read the full text.

Inputs: to, from, limit, query, +5 more.

send_messageA

Send a new email immediately. This goes out the moment it runs — the client should confirm first. To let a human review before sending, use create_draft instead. Can include local file attachments.

Inputs: to (required), subject (required), cc, bcc, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 8 tools

    Disambiguation4/5

    Most tools are clearly distinct: search/get/download form a retrieval pipeline, and create_draft/send_message are explicitly contrasted. reply, reply_all, and forward could be confused, but their descriptions precisely define recipient behavior and threading.

    Naming Consistency4/5

    Most tools follow a clear verb_noun pattern like search_mail, get_message, download_attachment, create_draft, send_message. However, reply and forward are bare verbs, and reply_all mixes a verb with an adverb, creating minor inconsistency.

    Tool Count5/5

    Eight tools is a well-scoped set for an email-focused server. Each tool covers a distinct core email action without unnecessary redundancy or bloat.

    Completeness4/5

    The set covers search, read, download attachments, reply, reply-all, forward, draft, and send — the essential email workflows. Minor gaps like delete, move, or archive exist, but agents can handle common tasks end-to-end.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A read-only MCP server that connects to Proton Mail via Proton Bridge, enabling AI assistants to search, list, and read emails securely without leaving your machine.
      4
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that connects to ProtonMail via Bridge, enabling AI assistants like Claude to manage your email.
      3
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      A lightweight MCP server providing AI agents a scoped, read-and-draft-only view into Proton Mail via Proton Bridge, with code-enforced restrictions preventing external access or sending.
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      A security-first MCP server that provides AI agents with a scoped, read-and-draft-only view into Proton Mail via Proton Bridge, ensuring no emails can be sent and access is restricted to configured workspaces.
      5
      -