Note
本文描述由 標準線束驅動的代理或代理流程中使用的功能。
Important
這是預覽功能。
- Microsoft 會在正式發行前釋出預覽功能，讓客戶能搶先體驗並提供回饋。
- 預覽功能功能有限，且不適合生產環境使用。
- Microsoft 可能會更改預覽版 MCP 工具名稱和參數。 避免硬編碼的相依關係。 Microsoft 維持情境支援。
- 預覽功能須遵守Microsoft補充使用條款。
Note
針對特定應用程式的 Microsoft 365 MCP 工具（Copilot、行事曆、郵件、SharePoint、OneDrive、Teams、User 和 Word）僅用於向下相容，不應用於生產環境或新專案。 對於需要存取 Microsoft 365 資源的新專案，請使用 Work IQ MCP 搭配 Microsoft Copilot 工具。 欲了解更多資訊，請參閱 Copilot Studio 中的 Work IQ MCP。
概觀
| 伺服器識別碼 | 租戶層級 URL | 顯示名稱 | Description |
|---|---|---|---|
mcp_MailTools |
https://agent365.svc.cloud.microsoft/agents/tenants/{tenantId}/servers/mcp_MailTools |
郵件 | Microsoft Graph 郵件操作工具，包括建立、發送、回覆及管理電子郵件。 |
可用工具
mcp_MailTools_graph_mail_createMessage
建立一封草稿電子郵件。 透過設定 body.body.contentType = "HTML"支援 HTML 。
必要參數：
- 主旨： 訊息主旨
- toRecipients: 收件者陣列及電子郵件地址
- 正文： 訊息正文，內容類型（Text/HTML）及內容
選擇性參數：
- preferHtml： 將 preferHtml 設為 true，以用於 HTML 內容。
- 標頭： 可選的額外標頭
mcp_郵件工具_圖形_郵件_刪除訊息
刪除已登入使用者信箱中的訊息。
必要參數：
- ID： 訊息識別碼
選擇性參數：
-
If-Match： 可選
ETag用於並行存取控制
mcp_MailTools_graph_mail_getMessage
從已登入使用者的信箱中依 ID 取得訊息。 使用 preferHtml 來請求 HTML 主體。
必要參數：
- ID： 訊息識別碼
選擇性參數：
- select: OData select 子句
- expand: OData expand 子句
- preferHtml： 請求 HTML 正文格式
- 標頭： 可選的 HTTP 標頭
mcp_MailTools_graph_mail_listSent
在已寄件的郵件中列出訊息。
選擇性參數：
- 篩選： OData 篩選
- 搜尋： 搜尋查詢
- orderby： 排序表達式
- top: 要傳回的項目數量
- select: 回傳欄位
mcp_MailTools_graph_mail_reply
回覆現有訊息。 支援透過 preferHtml 或 headers 實現的 HTML。
必要參數：
- ID： 要回覆的訊息 ID
選擇性參數：
- 註解： 回覆文字
- 訊息： 可選的訊息覆寫
- preferHtml： 啟用 HTML 格式化
- 標頭： 可選的 HTTP 標頭
郵件工具_圖形_郵件_全部回覆
請對現有訊息使用「全部回覆」。 支援透過 preferHtml 或 headers 實現的 HTML。
必要參數：
- ID： 要回覆所有收件者的訊息 ID
選擇性參數：
- 留言： 回覆文字
- 訊息： 可選的訊息覆寫
- preferHtml： 啟用 HTML 格式化
- 標頭： 可選的 HTTP 標頭
mcp_MailTools_graph_mail_searchMessages
使用 Microsoft Graph Search API 搭配關鍵字查詢語言（KQL）風格查詢，搜尋 Outlook 訊息。
必要參數：
-
請求： 搜尋請求陣列，包含
entityTypes、query、from、size 參數
支援搜尋訊息內容、主旨、正文及附件
mcp_MailTools_graph_mail_sendDraft
用 ID 發送已存在的草稿訊息。
必要參數：
- ID： 要發送的草擬訊息 ID
mcp_MailTools_graph_mail_sendMail
以登入使用者身份寄電子郵件。
必要參數：
-
訊息： 訊息物件，包含主旨、
toRecipients和內文 - 主旨： 電子郵件主旨
- 收件人： 主要收件人
- 正文： 電子郵件正文，內容類型（Text/HTML）及內容
選擇性參數：
- 抄送收件人: 抄送收件人
- BCC 收件人： 密件副本收件人
- saveToSentItems: 儲存到已傳送項目（預設：true）
- preferHtml： 強制 HTML 呈現
- 標頭： 可選的額外 HTTP 標頭
10. mcp_MailTools_graph_mail_updateMessage
更新訊息的可變屬性，例如主旨、主體和類別。
必要參數：
- ID： 訊息識別碼
選擇性參數：
- 主旨： 新主旨
- 正文： 新訊息主體
- 分類： 訊息分類
- 重要性： 低、普通或高
-
If-Match：
ETag用於並行控制
關鍵功能
電子郵件撰寫
- 製作草稿並發送電子郵件
- HTML 與純文字支援
- 收件人、抄送及密件副本收件人
- 豐富格式選項
Email 管理
- 接收、更新及刪除訊息。
- 回覆和全部回覆功能。
- 草稿管理。
- 分類與重要性設定。
搜尋與篩選
- KQL 風格的訊息搜尋。
- OData 查詢支援。
- 在主旨、內文及附件中搜尋。
- 分頁與過濾。
傳送物品
- List已經發送訊息了。
- 可選擇儲存到寄件備份。
- 篩選並搜尋已寄件物品。
附註
- 所有操作皆使用 Microsoft Graph Mail API。
- HTML 內容需要
contentType = "HTML"在正文中。 -
preferHtml標頭要求 HTML 正文格式。 - 搜尋使用 Microsoft Graph Search API 搭配 KQL 查詢。
- 草稿訊息可以分別建立、更新並傳送。
-
ETag支援更新時的並行控制。