MCP Reference: gmailmcp.googleapis.com

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

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' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'