Outlook Mail

mcp-outlook-mail

Outlook Mail（Microsoft 365）MCP パック

Pipeworx の一部です — AI エージェントを1683以上の稼働中のデータソースに接続するMCPゲートウェイです。

ツール

ツール	説明
outlook_list_messages	Outlook / Microsoft 365 メールボックスのフォルダー（既定：受信トレイ）からメールメッセージを一覧表示します。コンパクトなメッセージの概要（件名、送信者、受信日時、プレビュー、既読状態、添付ファイルの有無）を返します。キーワード検索と未読のみのフィルタリングに対応しています。ユーザーのOutlookメールを閲覧するために使用します。
outlook_get_message	IDを指定して、単一のOutlook / Microsoft 365メールメッセージの全内容を取得します。件名、送信者、宛先（to/cc）、受信日時、本文全体（HTMLまたはテキスト）が含まれます。メール全文を読むには、outlook_list_messages または outlook_search_messages の後に使用します。
outlook_list_folders	Outlook / Microsoft 365 メールボックス内のメールフォルダーを、表示名、未読件数、アイテムの総数とともに一覧表示します。メッセージを一覧表示する前に、フォルダー名やIDを確認するために使用します。
outlook_search_messages	Outlook / Microsoft 365 メールボックス全体をキーワードで検索します。一致したメールの概要（件名、送信者、受信日時、プレビュー）を返します。フォルダーに関係なく、トピック、送信者、内容からメールを探すために使用します。
outlook_get_profile	サインイン中のユーザーのMicrosoft 365 / Outlookプロフィールを取得します。表示名、メールアドレス、ユーザープリンシパル名、役職、携帯電話番号が含まれます。接続されているメールボックスのユーザーを確認するために使用します。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurfなど）に追加します。

{
  "mcpServers": {
    "outlook-mail": {
      "url": "https://gateway.pipeworx.io/outlook-mail/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/outlook-mail/mcp の tools/list は、上記の表のツールに加えて、共通のPipeworxメタツールである ask_pipeworx、 discover_tools、search_within、remember/recall など、ゲートウェイ全体で利用できるツールも返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、このパック独自のツールとともに、およそ30個の共通ツールが一覧表示されます。接続の initialize 応答には正確な範囲が記載されており、その日の状況を確認するための信頼できる情報源です。

これは意図的な設計であり、偶然に多重化しているわけではありません。スコープを限定した接続でも、このパックが対応していない質問に答えられるのは、カタログ全体を横断してルーティングする ask_pipeworx などのメタツールがあるためです。別のMCPサーバーを追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、フルPipeworxゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらのURLも、同じゲートウェイと同じ1683以上のデータソースに接続します。異なるのは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントをお持ちでない場合は、HTTP経由で呼び出す

このパックは接続済みのmicrosoftアカウントを使用するため、Pipeworxキーが必要です。https://pipeworx.io/account でサインインしてmicrosoftに接続し、Authorization: Bearer <your Pipeworx key> を指定して POST https://gateway.pipeworx.io/v1/tools/outlook_list_messages を呼び出します。ツールの詳細を確認するには、GET https://gateway.pipeworx.io/v1/tools/outlook_list_messages を実行します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を呼び出します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルのstdio MCPサーバーとしても実行できます。Pipeworxアカウントも、ゲートウェイへの往復通信も不要です。

{
  "mcpServers": {
    "outlook-mail": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-outlook-mail"]
    }
  }
}

または、直接実行して起動することを確認します。

npx -y @pipeworx/mcp-outlook-mail

stdin/stdout経由でMCPを通信し、このパックのツールのみを対象に initialize/tools/list/tools/call に応答します。上記のゲートウェイ接続で追加される共通メタツールは含まれません。同じソース、同じツールで、ask_pipeworxによるルーティングはありません。

ask_pipeworx での使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。 これは、上記のパックエンドポイントでも、フルゲートウェイでも機能します。

ask_pipeworx({ question: "your question about Outlook Mail data" })

ゲートウェイが適切なツールを選択し、引数を自動的に入力します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT