@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を使用してください。一致するメールの数に関係なく、1回のIMAP SEARCHと1回の一括コマンドで実行されます。

• ドライラン: bulkActionはデフォルトでdryRun: trueになっています。破壊的な操作を実行する前に、影響を受けるメールをプレビューしてください。

開発

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