CoolUtils Mail Viewer

Mail Viewer MCP サーバー

Claude、Cursor、Cline、およびMCP互換のあらゆるAIエージェントが、メールファイル（.eml、.msg、.p7m、.mim、.tnef、.vcf、.olk15など）の読み取り、変換、添付ファイルの抽出を行えるModel Context Protocolサーバーです。

このサーバーは**CoolUtils Mail Viewerに組み込まれている**ため、追加でインストールするものはありません。MailViewer.exe --mcpを実行すると、プログラムはGUIを起動せず、stdio JSON-RPCサーバーとして動作します。

できること

接続したら、AI アシスタントに自然言語で指示できます。

• 「D:\archiveにあるすべての.msgファイルをPDFに変換して、D:\outputに保存して」 — エージェントは各ファイルに対してconvert_mailを呼び出します。
• 「このEMLの添付ファイルと送信者を教えて」 — get_mail_infoは、整ったJSONオブジェクトをすぐに返します。
• 「この40件のメールからすべての添付ファイルをC:\attachmentsに抽出して」 — extract_attachmentsは、すべてを一度に保存します。

すべての処理はローカルで実行されます。メールファイルがアップロードされることはありません。

ツール

convert_mail

Mail Viewerの完全なレンダリングエンジンを使用して、メールファイルを指定した出力形式に変換します。

• 入力形式： .eml、.msg、.mim、.p7m、.vmbx、.tnef、.mapixml、.olk15、.vcf、.contact、.3uc
• 出力形式： pdf、html、txt、doc、rtf、tiff、jpg、png、bmp、emf、eml、xps

PDFおよびDOCXへの出力では、埋め込みHTML、インライン画像、添付ファイルのプレビュー、メッセージヘッダーが保持され、GUIで表示される内容と同じになります。

get_mail_info

メールファイルを読み取り、送信者、To／CC／BCCの受信者、件名、日付、生のRFCヘッダー、プレーンテキスト本文とHTML本文、名前・サイズ・コンテンツタイプを含む添付ファイル一覧を、メタデータとしてJSONで返します。元のファイルは変更されません。

extract_attachments

メールファイルからすべての添付ファイルを対象フォルダーに保存します（存在しない場合は自動的に作成されます）。保存したファイルの絶対パスとサイズ（バイト単位）の一覧を返します。

入力／出力スキーマの全容は、schemas/mcp-tools.jsonを参照してください。

インストール

1. Mail Viewerをインストールする

https://www.coolutils.com/MailViewerから、Windows用のCoolUtils Mail Viewerをダウンロードしてインストールします。MCPサーバーは標準のMailViewer.exeバイナリに組み込まれているため、追加パッケージや別途ライセンスは必要ありません。

30日間の無料トライアルを利用できます。メールアドレスやクレジットカードは不要です。

2. MCPクライアントを設定する

Claude Code

~/.claude.jsonのmcpServersの下に追加します。

{
  "mcpServers": {
    "mailviewer": {
      "command": "C:\\Program Files\\CoolUtils\\CoolUtils Mail Viewer\\MailViewer.exe",
      "args": ["--mcp"]
    }
  }
}

Claude Desktop

%APPDATA%\Claude\claude_desktop_config.jsonのmcpServersの下に追加します（上記と同じブロックです）。

Cursor

プロジェクト内の.cursor/mcp.json、またはグローバル設定の~/.cursor/mcp.jsonに追加します（同じJSONブロックです）。

Cline

ClineのMCP設定UIを開き、同じブロックを貼り付けます。

実行ファイルと同じ場所には、コピーしてすぐに使えるスニペットclaude-config-snippet.jsonもインストールされます。Mail Viewerを既定以外の場所にインストールした場合は、パスを調整してください。

3. 動作を確認する

サーバーが応答することを確認するには、コマンドプロンプトで次を実行します。

echo {"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"t","version":"0"}}} | "C:\Program Files\CoolUtils\CoolUtils Mail Viewer\MailViewer.exe" --mcp

protocolVersion、serverInfo、およびtools機能を含むJSON-RPC応答が1つ表示されます。

使用例

一連の操作を示す記録は、examples/usage.mdを参照してください。

• フォルダー内の一括変換 — .msgファイルがあるディレクトリをClaudeに指定し、PDFへの変換を依頼します。
• フォレンジック調査 — 100件のメールにわたる送信者／件名／添付ファイルの傾向をClaudeに要約させます。
• 添付ファイルの収集 — 1四半期分の法務関連メールから、すべての添付ファイルを1つのフォルダーに抽出します。

技術詳細

• トランスポート: stdio（NDJSON、1 行につき JSON-RPC 2.0 メッセージ 1 件、UTF-8）
• プロトコルバージョン: 2024-11-05
• サーバー名（initialize で報告）: mailviewer-mcp
• プラットフォーム: Windows 7 / 8 / 10 / 11
• ライセンス: 商用（Mail Viewer）；MIT（この設定／ドキュメントリポジトリ）。個人向けライセンスは $49.90 からで、30 日間の無料トライアルがあります。

サーバーマニフェスト: schemas/mcp-server.json。

トラブルシューティング

サーバーが応答しません。 実行ファイルのパスが正しいことを確認してください。Windows のデフォルトのインストール先は C:\Program Files\CoolUtils\CoolUtils Mail Viewer\MailViewer.exe です。32 ビット版をインストールした場合は、C:\Program Files (x86)\… を使用してください。

Claude がツールを見つけられません。 設定ファイルを編集した後、MCP クライアントを再起動してください。クライアントのログを確認してください。Claude Desktop の場合は、%APPDATA%\Claude\logs を参照してください。

ファイルパスのエラー。 プロンプトでは絶対パスを使用してください。スラッシュ（/）とバックスラッシュ（\）のどちらも使用できます。スペースを含むパスは引用符で囲んでください。

トライアルの有効期限が切れました。 ライセンスを購入してください。個人向けライセンスは $49.90 からです。MCP サーバーは同じバイナリで引き続き動作します。

リソース

• Mail Viewer 製品ページ
• coolutils.com の MCP 記事
• Model Context Protocol 仕様
• CoolUtils サポート

ライセンス

このリポジトリの設定ファイル、スキーマ、ドキュメントは、MIT License の下で公開されています。CoolUtils Mail Viewer 自体は商用ソフトウェアです。ライセンスについては製品ページをご覧ください。