outlook-classic-windows-mcp

ローカルに構成された クラシック Outlook for Windows デスクトッププロファイルを操作するための MVP MCP サーバー。

これは Microsoft Graph、Outlook on the web、新しい Outlook for Windows、または管理者が有効化したクラウド API を使用しません。MCP サーバーが実行されているマシンで利用可能なクラシック Outlook デスクトップアプリ/プロファイルに対して、Windows COM オートメーションを使用します。これは、IT サポートに連絡したり、管理者の承認を求めたりしたくない場合に役立ちます。

注: この MCP は、私自身のワークフローと要件に固有のものです。自分の Outlook 環境とユースケースに合わせて MCP を調整するには、フォークして変更するか、コーディングエージェントに依頼することをお勧めします。

警告: Microsoft 365 ユーザー向けのクラシック Outlook for Windows は、少なくとも 2029 年までサポートされます。新しい Outlook が徐々にデフォルトまたは置き換えになります。この MCP は、近い将来/中期的にのみ有効です。長期的には、管理者がバックアップした API を使用する別の MCP を使用してください! https://learn.microsoft.com/en-us/answers/questions/5554339/when-will-classic-outlook-end を参照してください。

要件

• Windows

• Classic Microsoft Outlook デスクトップがインストールされ、構成されていること

• uv

インストール / 実行

cd C:\Users\muhammad.menjeni\git\outlook-classic-windows-mcp
uv sync
uv run outlook-local-mcp

MCP サーバーは stdio を話すため、MCP クライアントによって起動されることを意図しています。

Pi MCP 設定例

Pi MCP 設定に、必要に応じてパスを調整して、次のようなローカルサーバーエントリを追加します:

{
  "mcpServers": {
    "outlook-local": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\Users\\muhammad.menjeni\\git\\outlook-classic-windows-mcp",
        "run",
        "outlook-local-mcp"
      ]
    }
  }
}

ツール

search_email

Outlook メールを件名および/または本文で検索します。

引数:

• query string: 大文字小文字を区別しない部分文字列を検索します。

• folder string: 検索するフォルダー。デフォルト: Inbox。Inbox/Archive や Mailbox Name/Inbox のようなパスを使用できます。

• search_scope: all、subject、または body。デフォルト: all。

• max_results: 返す一致数。デフォルト: 10。

• max_items: フォルダー内で検査する最新アイテム数。デフォルト: 500。

• include_body_preview: 短い本文プレビューを含めるかどうか。デフォルト: true。

list_mail_folders

利用可能な Outlook フォルダーを一覧表示して、フォルダーパスの選択に役立てます。

create_leave_calendar_blocks

休暇レビュー用に、送信されない 2 つの Outlook カレンダーアイテムを作成します:

1. 出席者なしの Out of Office とマークされた個人用ブロッカー。

2. 指定された出席者を含む Free とマークされた通知ミーティング。

何も送信されません。デフォルトでは、両方のアイテムが保存され、手動レビュー/送信のために Outlook で開かれます。

引数:

• start_time string: 開始日時。例: 2026-09-01 08:00。

• end_time string: 終了日時。終日イベントの場合、これは排他的な終了として解釈されます。例: 2026-09-04 00:00 から 2026-09-05 00:00 まで 1 日。

• required_attendees list/string: 追加の通知受信者。設定可能なデフォルトも使用できます。

• subject string: デフォルトは設定から取得され、初期値は Amirul: On-Leave です。

• body string: メッセージ本文。

• optional_attendees list/string: オプションの通知受信者。

• location string。

• display boolean: 保存したアイテムを Outlook で開くかどうか。デフォルト: true。

• confirmed boolean: 実際に Outlook カレンダーアイテムを作成するには true である必要があります。確認がない場合、ツールは提案のみを返します。

get_leave_defaults

現在の休暇デフォルトと設定パスを表示します。

set_leave_defaults

件名や通知受信者などの休暇デフォルトを永続化します。設定を書き込む前に confirmed=true が必要です。

infer_leave_recipients

最近のローカル Outlook メールを読み取り専用でスキャンして、休暇通知の候補配布リストを推測します。候補と証拠を返します。設定を書き込んだり、下書きを作成したりしません。

resolve_recipients

Outlook の受信者解決/アドレス帳を使用して、名前、メール、または配布リストを解決します。

search_contacts

名前、メール、会社、部署、または役職でローカル Outlook 連絡先フォルダーを検索します。

注記 / 制限事項

• 最初のアクセスでは、Outlook がまだ実行されていない場合、Outlook が起動されることがあります。

• 組織によっては、Outlook オブジェクトモデルガードのプロンプトが表示されたり、ポリシーによって自動化がブロックされたりする場合があります。

• この MVP は、最近のフォルダーアイテムをスキャンして検索します。これはシンプルで信頼性がありますが、非常に大きなフォルダーではインデックス化された Outlook 検索ほど高速ではありません。