AI导哈

Gmail API工具集

Gmail MCP Server提供了一套通过OAuth 2.0认证与Gmail进行程序化交互的工具集，支持搜索、读取、发送和管理邮件。

  • by Ansh-Wappnet
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 ansh-wappnet/gmail_mcp_server

使用说明

📧 Gmail MCP服务器

Gmail MCP服务器提供了一个工具集，使用OAuth 2.0身份验证以编程方式与Gmail交互。它使您能够使用标准化的界面高效地搜索、阅读、发送和管理电子邮件。

📘 谷歌云设置

在使用Gmail MCP服务器之前，您必须设置Google Cloud项目，启用Gmail API，并创建OAuth 2.0凭据。

1.创建谷歌云项目

  • 转到 谷歌云控制台.
  • 单击顶部的项目下拉列表并选择 新项目.
  • 输入项目名称（例如。， Gmail MCP Server)然后单击 创建.

2.启用Gmail API

3.创建OAuth 2.0凭据（桌面客户端）

  • 在云控制台中，转到 API和服务>凭据.
  • 点击 +创建凭据 并选择 OAuth客户端ID.
  • 如果出现提示，请配置同意屏幕：
    • 设置 应用程序类型 向 External.
    • 填写必填字段（应用程序名称、用户支持电子邮件等）。
  • 对于 应用程序类型，选择 桌面应用程序.
  • 输入名称（例如。， Gmail MCP Desktop Client)然后单击 创建.
  • 下载凭据文件(credentials.json)并安全地储存。您需要此文件进行身份验证。

🛠️ 可用工具

Gmail MCP服务器提供以下与Gmail交互的工具：

  • 搜索邮件
    使用Gmail的高级搜索语法（例如，按发件人、主题、日期）搜索电子邮件。

  • get_recent_emails
    从您的Gmail收件箱中检索最新电子邮件。

  • get_email_details
    使用邮件ID获取特定电子邮件的完整详细信息（标题、正文、元数据）。

  • send_邮件
    使用经过身份验证的Gmail帐户发送新电子邮件。

  • list_gmail_labels
    列出您的Gmail帐户中配置的所有可用标签（例如，收件箱、已启动、已发送）。

  • get_emails_by_label
    检索属于特定Gmail标签的电子邮件。

  • 健康检查
    检查Gmail MCP服务器的运行状况和连接情况，以确保其正常运行。

🖥️ Claude桌面配置

要使用 Gmail MCP服务器 使用Claude Desktop，更新您的Claude配置文件，以包含以下条目 mcpServers.更换 CREDENTIALS_FILE 随着 绝对路径 到您下载的 credentials.json 从谷歌云控制台下载文件。

{
  "mcpServers": {
    "gmail_mcp": {
      "command": "uvx",
      "args": [
        "gmail-mcp-server-ansh",
        "--credentials-file", "CREDENTIALS_FILE"
      ]
    }
  }
}

🔧 程序化使用

如果你正在整合 Gmail MCP服务器 在您自己的应用程序（如自定义代理系统）中，您可以使用 params 字典如下所示。同时更换 CREDENTIALS_FILE 随着 绝对路径 到您下载的 credentials.json 从谷歌云控制台下载文件。

params = {
    "command": "uvx",
    "args": [
        "gmail-mcp-server-ansh",
        "--credentials-file", "CREDENTIALS_FILE"
    ]
}```

相关 MCP