Work IQ メール リファレンス (プレビュー)

Important

これはプレビュー機能です。

  • Microsoftは、お客様が早期にアクセスしてフィードバックを提供できるように、公式リリースの前にプレビュー機能をリリースします。
  • プレビュー機能は機能が制限されており、運用環境での使用を目的としていません。
  • Microsoftは、プレビュー MCP ツールの名前とパラメーターを変更する可能性があります。 ハードコーディングされた依存関係を回避します。 Microsoftでは、シナリオのサポートが維持されます。
  • プレビュー機能には、Microsoft追加の使用条件が適用されます。

Overview

サーバー ID テナントレベルの URL 表示名 Description
mcp_MailTools https://agent365.svc.cloud.microsoft/agents/
tenants/{tenantId}/servers/mcp_MailTools		 Work IQ メール Microsoft Graphメール ツールを提供する MCP サーバー。

使用可能なツール

mcp_MailTools_graph_mail_createMessage

メールの下書きを作成します。 body.body.contentType = "HTML"設定でHTMLをサポートします。

[Required parameters]\(必須のパラメーター\):

  • subject: メッセージの件名
  • toRecipients: メール アドレスを持つ受信者の配列
  • 本文: Message body が contentType (Text/HTML) とコンテンツを含む

オプション パラメーター:

  • preferHtml: HTML コンテンツの場合は true に設定
  • headers: オプションの追加ヘッダー

mcp_MailTools_graph_mail_deleteMessage

サインインしているユーザーのメールボックスからメッセージを削除します。

[Required parameters]\(必須のパラメーター\):

  • id: メッセージ ID

オプション パラメーター:

  • IF-マッチ:並行制御のためのオプションETag

mcp_MailTools_graph_mail_getMessage

サインインしているユーザーのメールボックスから ID でメッセージを取得します。 preferHtmlを使ってHTML本文をリクエストしてください。

[Required parameters]\(必須のパラメーター\):

  • id: メッセージ ID

オプション パラメーター:

  • select: OData の select 句
  • expand: OData の expand 句
  • preferHtml: HTML本文フォーマットを要求する
  • headers: オプションの HTTP ヘッダー

mcp_MailTools_グラフ_メール_リスト送信

送信されたアイテムにメッセージをリストにしてください。

オプション パラメーター:

  • filter: OData フィルター
  • search: 検索クエリ
  • orderby: ソート式
  • top: 返す項目の数
  • select: 返却するフィールド

mcp_MailTools_graph_mail_reply

既存のメッセージに返信を送信します。 preferHtml または headers を介して HTML をサポートします。

[Required parameters]\(必須のパラメーター\):

  • id: 返信先のメッセージ ID

オプション パラメーター:

  • comment: 応答テキスト
  • message: オプションのメッセージの上書き
  • preferHtml: HTML 形式の有効化
  • headers: オプションの HTTP ヘッダー

mcp_メールツール_graph_メール_すべて返信

既存のメッセージへの全員の返信を送信します。 preferHtml または headers を介して HTML をサポートします。

[Required parameters]\(必須のパラメーター\):

  • id: 全員への返信のメッセージ ID

オプション パラメーター:

  • comment: 応答テキスト
  • message: オプションのメッセージの上書き
  • preferHtml: HTML 形式の有効化
  • headers: オプションの HTTP ヘッダー

mcp_MailTools_graph_mail_searchMessages

キーワード クエリ言語 (KQL) スタイルのクエリMicrosoft Graph Search API を使用して Outlook メッセージを検索します。

[Required parameters]\(必須のパラメーター\):

  • リクエスト:entityTypes、query、from、sizeパラメータを持つ検索リクエストの配列

メッセージの内容、件名、本文、添付ファイルの検索をサポートします

mcp_MailTools_graph_mail_sendDraft

既存の下書きメッセージを ID ごとに送信します。

[Required parameters]\(必須のパラメーター\):

  • id: 送信する下書きのメッセージ ID

mcp_MailTools_graph_mail_sendMail

サインイン ユーザーとしてメールを送信します。

[Required parameters]\(必須のパラメーター\):

  • メッセージ： 主語、 toRecipients、本文を持つメッセージオブジェクト
  • subject: 電子メールの件名
  • toRecipients: プライマリ受信者
  • 本文: コンテンツタイプ（テキスト/HTML）と内容を含むメールの本文

オプション パラメーター:

  • ccRecipients: カーボンコピーの受信者
  • bccRecipients: ブラインド・カーボンコピー (BCC) の受信者
  • saveToSentItems: 送信されたアイテムに保存する(デフォルト:true)
  • preferHtml: HTML レンダリングの強制
  • headers: オプションの追加 HTTP ヘッダー

10. mcp_MailTools_graph_mail_updateMessage

件名、本文、カテゴリなど、メッセージの変更可能なプロパティを更新します。

[Required parameters]\(必須のパラメーター\):

  • id: メッセージ ID

オプション パラメーター:

  • subject: 新しい件名
  • body: 新しいメッセージ本文
  • categories: メッセージ カテゴリ
  • 重要度: 低、通常、または高
  • イフマッチ:ETag 同時実行制御のために

主要な機能

電子メールの構成

  • 下書きを作成してメールを送信する
  • HTML とプレーン テキストのサポート
  • To、CC、BCC の受信者
  • 豊富な書式設定オプション

メール管理

  • メッセージを取得、更新、および削除します。
  • 応答および全員に返信する機能。
  • ドラフト管理。
  • カテゴリと重要度の設定。

検索とフィルター処理

  • KQL スタイルのメッセージ検索。
  • OData クエリのサポート。
  • 件名、本文、添付ファイルを検索します。
  • ページネーションとフィルタリング。

センチメント

  • 送信されたメッセージを一覧表示します。
  • 送信済みアイテムへの保存はオプションです。
  • 送信されたアイテムをフィルター処理して検索します。

Notes

  • すべての操作でメール API Microsoft Graph使用されます。
  • HTML コンテンツの本文には contentType = "HTML" が必要です。
  • preferHtml ヘッダーは HTML 本文形式を要求します。
  • 検索では、KQL クエリを使用して Microsoft Graph Search API を利用します。
  • 下書きメッセージは、個別に作成、更新、送信できます。
  • ETag 更新プログラムのコンカレンシー制御のサポート。
  • Last updated on