MCP Reference: gmailmcp.googleapis.com

這是 Gmail API 提供的 MCP 伺服器。這個伺服器提供工具，供開發人員在 Gmail 上建構 LLM 應用程式。

Model Context Protocol (MCP) 伺服器可做為代理伺服器，在外部服務與大型語言模型 (LLM) 或 AI 應用程式之間傳輸脈絡、資料或功能。MCP 伺服器可將 AI 應用程式連結至資料庫和 Web 服務等外部系統，並將系統回覆轉換成 AI 應用程式可理解的格式。

伺服器設定

您必須先設定 Gmail MCP 伺服器，才能使用這項功能。如要進一步瞭解如何使用 Google 和 Google Cloud 遠端 MCP 伺服器，請參閱 Google Cloud MCP 伺服器總覽。

伺服器端點

MCP 服務端點是 MCP 伺服器的網路位址和通訊介面 (通常是網址)，AI 應用程式 (MCP 用戶端的主機) 會使用這個端點建立安全標準連線。這是 LLM 請求內容、呼叫工具或存取資源的聯絡點。Google MCP 端點可以是全域或區域。

Gmail API MCP 伺服器具有下列全域 MCP 端點：

https://gmailmcp.googleapis.com/mcp/v1

MCP 工具

MCP 工具是 MCP 伺服器向 LLM 或 AI 應用程式公開的函式或可執行功能，可在現實世界中執行動作。

工具

gmailmcp.googleapis.com MCP 伺服器提供下列工具：

MCP 工具
create_draft	在已驗證使用者的 Gmail 帳戶中建立新的電子郵件草稿。這項工具會將收件者地址、主旨和內文內容做為輸入內容。並傳回建立的 Gmail 草稿 ID。
list_drafts	列出已驗證使用者 Gmail 帳戶中的草稿電子郵件。這項工具可根據查詢字串篩選草稿，並支援分頁。系統會傳回草稿清單，包括草稿 ID 和主旨。
get_thread	從已驗證使用者的 Gmail 帳戶擷取特定電子郵件討論串，包括郵件清單。
search_threads	列出已驗證使用者 Gmail 帳戶中的電子郵件討論串。這項工具可根據查詢字串篩選執行緒，並支援分頁。系統會傳回討論串清單，包括 ID 和相關訊息。每封相關郵件都會顯示詳細資料，例如郵件內文片段、主旨、寄件者、收件者等。請注意，這項工具不會傳回完整郵件內文；如要擷取完整郵件內文，請使用「get_thread」工具和執行緒 ID。
label_thread	在已驗證使用者的 Gmail 帳戶中，為整個郵件串加上標籤。這項操作會影響目前在對話串中的所有訊息，以及日後新增至對話串的訊息。如果不確定執行緒 ID，請先使用 `search_threads` 工具。如果不確定使用者標籤的 ID，請先使用 `list_labels` 工具找出可用的標籤及其 ID。
unlabel_thread	從已驗證使用者 Gmail 帳戶的整個郵件串中移除標籤。如果不確定執行緒 ID，請先使用 `search_threads` 工具。如果不確定使用者標籤的 ID，請先使用 `list_labels` 工具。
list_labels	列出已驗證使用者 Gmail 帳戶中所有使用者定義的標籤。請先使用這項工具找出使用者標籤的 `id`，再呼叫 `label_thread`、`unlabel_thread`、`label_message` 或 `unlabel_message`。這項工具不會傳回系統標籤，但可以搭配已知的 ID 使用：'INBOX'、'TRASH'、'SPAM'、'STARRED'、'UNREAD'、'IMPORTANT'、'CHAT'、'DRAFT'、'SENT'。
label_message	為已驗證使用者 Gmail 帳戶中的特定郵件加上一或多個標籤。如要找出郵件 ID，請使用 `search_threads` 或 `get_thread` 等工具。如果不確定使用者標籤的 ID，請先使用 `list_labels` 工具找出可用的標籤及其 ID。
unlabel_message	從已驗證使用者 Gmail 帳戶的特定郵件中移除一或多個標籤。如要找出郵件 ID，請使用 `search_threads` 或 `get_thread` 等工具。如果不確定使用者標籤的 ID，請先使用 `list_labels` 工具找出可用的標籤及其 ID。
create_label	在已驗證使用者的 Gmail 帳戶中建立新標籤。

取得 MCP 工具規格

如要取得 MCP 伺服器中所有工具的 MCP 工具規格，請使用 tools/list 方法。以下範例說明如何使用 curl 列出 MCP 伺服器中目前可用的所有工具及其規格。

Curl 要求
curl --location 'https://gmailmcp.googleapis.com/mcp/v1' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/list", "jsonrpc": "2.0", "id": 1 }'

Curl 要求

curl --location 'https://gmailmcp.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'