@darkroomhq/protonmail-mcp

Proton Bridge를 통해 AI 어시스턴트가 귀하의 ProtonMail 계정에 완전히 액세스할 수 있도록 하는 MCP 서버입니다. MCP 호환 클라이언트를 통해 이메일을 읽고, 보내고, 검색하고, 관리하세요.

요구 사항

• 로컬에서 실행 중이며 로그인된 Proton Bridge

• Node.js 18 이상

Related MCP server: Proton Mail MCP Server

설치

npm install -g @darkroomhq/protonmail-mcp

또는 설치 없이 사용:

npx @darkroomhq/protonmail-mcp

구성

MCP 클라이언트 구성(예: claude_desktop_config.json)에 추가하세요:

{
  "mcpServers": {
    "protonmail": {
      "command": "protonmail-mcp",
      "env": {
        "PROTONMAIL_USERNAME": "your@protonmail.com",
        "PROTONMAIL_PASSWORD": "bridge-app-password"
      }
    }
  }
}

npx 사용 (전역 설치 불필요):

{
  "mcpServers": {
    "protonmail": {
      "command": "npx",
      "args": ["-y", "@darkroomhq/protonmail-mcp"],
      "env": {
        "PROTONMAIL_USERNAME": "your@protonmail.com",
        "PROTONMAIL_PASSWORD": "bridge-app-password"
      }
    }
  }
}

참고: PROTONMAIL_PASSWORD는 ProtonMail 계정 비밀번호가 아니라 Proton Bridge 앱에 표시된 브리지 앱 비밀번호입니다.

모든 환경 변수

도구

예시 프롬프트

읽기 및 요약

• "이번 주에 받은 읽지 않은 이메일을 요약해 줘."

• "alice에게서 온 최신 이메일을 읽고 그녀가 무엇을 요청하는지 알려줘."

검색

• "지난 30일 동안의 Q2 보고서에 관한 모든 이메일을 찾아줘."

• "보낸 편지함에서 플래그가 지정된 이메일을 검색해 줘."

보내기 및 답장

• "회의가 목요일 오후 3시로 변경되었다고 bob에게 이메일을 보내줘."

• "디자인 팀에서 온 마지막 이메일에 답장하고 업데이트된 목업을 요청해 줘."

대량 작업

• "받은 편지함에 있는 IGN의 모든 이메일을 삭제해 줘."

• "읽지 않은 모든 뉴스레터를 읽음으로 표시해 줘."

• "noreply@github.com에서 온 모든 이메일을 GitHub 폴더로 이동해 줘."

• "지난달에 플래그가 지정된 이메일이 몇 개나 있지?" (드라이 런 사용)

정리

• "받은 편지함의 모든 뉴스레터를 뉴스레터 폴더로 이동해 줘."

• "매니저에게서 온 최근 이메일 3개에 플래그를 지정해 줘."

• "스팸 폴더의 모든 이메일을 삭제해 줘."

• "'영수증'이라는 폴더를 만들고 모든 구매 확인 메일을 거기로 이동해 줘."

• "즉각적인 주의가 필요한 이메일에 대해 '긴급'이라는 라벨을 만들어 줘."

• "'오래된 프로젝트' 폴더 이름을 '아카이브'로 변경해 줘."

상태

• "Proton Bridge가 연결되어 있는지 확인해 줘."

성능 팁

• 커서 페이지 매김: 요청 사이에 새로운 이메일이 도착해도 영향을 받지 않는 안정적인 페이지 매김을 위해 page 대신 beforeUid(nextCursor로 반환됨)를 사용하세요.

• 헤더만 가져오기: 메타데이터만 필요한 경우 readEmail에서 headersOnly: true를 사용하여 전체 메시지 본문 다운로드를 건너뛰세요.

• 본문 자르기: readEmail에서 maxBodyLength를 사용하여 본문 크기를 제한(예: 2000자)하고 이메일이 많은 메시지에서 큰 응답이 오는 것을 방지하세요.

• 대량 작업: 개별 이메일을 반복하는 대신 검색 criteria와 함께 bulkAction을 사용하세요. 일치하는 이메일 수에 관계없이 단일 IMAP SEARCH + 단일 대량 명령을 실행합니다.

• 드라이 런: bulkAction은 기본적으로 dryRun: true로 설정되어 있습니다. 파괴적인 작업을 수행하기 전에 영향을 받는 이메일을 미리 확인하세요.

개발

npm install
npm run build   # compile TypeScript
npm run dev     # watch mode