Outlook MCP Server

Outlook MCP Server とは？

Outlook MCP Server は Windows 向けのコミュニティ製 outlook mcp server です。Claude などの MCP クライアントから、ローカルにインストールされた Microsoft Outlook を通じてメールの一覧表示、検索、閲覧、返信、送信ができます。

outlook_mcp_server.py という単一の Python スクリプトで、MCP Python SDK の FastMCP と pywin32 を使って作られています。クラウド API は呼び出さず、COM/MAPI 経由で Outlook デスクトップアプリを操作するため、Outlook にサインイン済みのアカウントがそのまま使われます。GitHub で Wallisking1991 が管理しており、Microsoft の公式製品ではありません。

Outlook MCP Server の使い方

前提条件

• Windows（サーバーは pywin32 と Outlook の COM インターフェースに依存します）
• Python 3.10 以降
• Microsoft Outlook がインストールされ、有効なアカウントが設定されていること
• Claude Desktop またはその他の MCP 対応クライアント

API キー、OAuth アプリ、Microsoft Graph の登録は不要です。サーバーはお使いのマシンの Outlook プロファイルを使用します。

インストール

GitHub からリポジトリをクローンまたはダウンロードし、依存パッケージをインストールします。

pip install mcp>=1.2.0 pywin32>=305

同じ 2 つのパッケージがリポジトリの requirements.txt にも記載されています。サーバーを手動で起動すると、Outlook に接続できるか確認できます。

python outlook_mcp_server.py

起動時に Outlook へ接続し、受信トレイのアイテム数を表示してから MCP サーバーを開始します。通常の利用では、MCP クライアントに起動を任せます。

Claude Desktop

Claude Desktop の MCP 設定にサーバーを追加し、パスをお使いのマシン上のスクリプトのフルパスに置き換えます。

{
  "mcpServers": {
    "outlook": {
      "command": "python",
      "args": ["Your path\\outlook_mcp_server.py"],
      "env": {}
    }
  }
}

保存後、Claude Desktop を再起動してください。リポジトリに含まれるサンプルの claude_desktop_config.json では、d:\\Cline\\MCP\\outlook_mcp_server.py のような Windows の絶対パスが使われています。JSON ではバックスラッシュを二重にする必要がある点に注意してください。

その他の MCP クライアント

サーバーは標準入出力（stdio）で動作するため、ローカルコマンドを起動できるクライアント（Cursor、VS Code、Claude Code など）であれば同じ command と args を使えます。README に記載されているのは Claude Desktop の設定のみなので、ローカル stdio サーバーの登録方法は各クライアントのドキュメントに従ってください。

Outlook MCP Server の主な機能

• フォルダー管理：Outlook クライアントで利用できるすべてのメールフォルダーを一覧表示します。
• メール一覧：受信トレイまたは指定したフォルダーから、過去 1〜30 日のメール件名を取得します。
• メール検索：連絡先名、キーワード、フレーズで検索でき、語句の間に OR を使えます。
• メールの詳細：一覧にあるメールの全文を、添付ファイルの情報も含めて表示します。
• 返信：直近の一覧での番号を指定してメールに返信します。
• 作成：新しいメールを作成して送信します。CC の宛先も指定できます。
• クラウド認証情報が不要：ローカルの Outlook デスクトップアプリ経由で動作し、Microsoft Graph の設定は要りません。

Outlook MCP Server のツール

README には 6 つのツールが記載されており、3 つのグループに分けられます。

閲覧と検索。 list_folders はメールボックス内のフォルダーを返します。list_recent_emails は指定日数分（デフォルト 7 日、最大 30 日）のメール件名を一覧表示し、フォルダー名も指定できます。search_emails は検索語と同じ days およびフォルダーのオプションを受け取り、project update OR meeting notes のような OR クエリに対応します。

閲覧（詳細）。 get_email_by_number は、直近の list_recent_emails または search_emails の結果で付けられた番号を使ってメールの全文を返します。先に一覧表示か検索を行わないと、このツールはエラーを返します。

書き込み。 reply_to_email_by_number は番号を指定したメールに、指定したテキストで返信します。compose_email は宛先、件名、本文、任意の CC アドレスを受け取り、下書き保存ではなくすぐにメールを送信します。

典型的な流れは、list_folders、次に list_recent_emails または search_emails、続いて get_email_by_number、最後に reply_to_email_by_number です。

Outlook MCP Server のユースケース

• 受信トレイの整理："Could you show me my unread emails from the last 3 days?"
• スレッドの検索："Search for emails about "project update OR meeting notes" in the last week"
• 文脈を踏まえた閲覧："Show me the details of email #2 from the list" と頼み、その後 Claude に要約やアクション項目の抽出を依頼します。
• 素早い返信："Reply to email #3 with: "Thanks for the information. I'll review this and get back to you tomorrow.""
• チャットからの送信："Send an email to john.doe@example.com with subject "Meeting Agenda" and body "Here's the agenda for our upcoming meeting...""

Outlook MCP Server と代替ツールの比較

この outlook mcp server はローカルで動作し、Windows 専用です。pywin32 でデスクトップ版 Outlook を操作するため Microsoft 365 のアプリ登録は不要ですが、macOS、Linux、リモートホストでは動作せず、対象もメールに限られます。

Microsoft Graph ベースの Outlook MCP サーバーは別のアプローチを取ります。クラウド上の Microsoft 365 メールボックスに接続し、多くの場合カレンダーや連絡先にも対応しますが、OAuth やアプリの設定が必要になります。ホスト型の例として Pipedream's Microsoft Outlook MCP があります。メールが Outlook ではなく Gmail にある場合は、Gmail MCP Server を参照してください。

Outlook MCP Server のトラブルシューティング

• 接続の問題：Outlook が起動しており、有効なアカウントで正しく設定されているか確認してください。python outlook_mcp_server.py を手動で実行すると、スクリプトが受信トレイにアクセスできるかわかります。
• 権限エラー：スクリプトには Outlook へのアクセス権限が必要です。MCP クライアントは Outlook を使っているのと同じ Windows ユーザーで実行してください。
• "No emails have been listed yet"：get_email_by_number と reply_to_email_by_number は直近の一覧をもとに動作します。先に list_recent_emails または search_emails を実行してください。
• 検索の問題：複雑な検索では語句の間に OR を入れてください。結果は Outlook の組み込み検索機能に依存します。
• サーバーのクラッシュやメールアクセスのエラー：Outlook の接続が安定しているか、そのメール番号が現在の一覧に存在するかを確認してください。