MCP Reference: gmailmcp.googleapis.com

Model Context Protocol (MCP) 服务器充当外部服务（为大语言模型 [LLM] 或 AI 应用提供上下文、数据或功能）与 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 账号中所有用户定义的标签。在调用 label_thread、unlabel_thread、label_message 或 unlabel_message 之前，使用此工具发现用户标签的 id。此工具不会返回系统标签，但可以使用其已知 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
}'