邮件助手

一个与Gmail API集成的MCP兼容服务器,用于根据自定义查询或最近活动获取和总结电子邮件,可与Claude Desktop配合使用实现免提操作邮箱。

  • by saathvikpd
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 saathvikpd/mcpemailassistant

使用说明

📬 Claude Desktop的电子邮件助手

EmailAssistant是一款兼容MCP的服务器,可与Gmail API集成,根据自定义查询或最近的活动获取和汇总电子邮件。它可以与Claude Desktop一起使用,与您的收件箱进行免提交互。


⚙️ 安装说明

1.启用Gmail API

  1. 首选 谷歌云控制台.
  2. 创建新项目或使用现有项目。
  3. 启用 Gmail API 在“API和服务”下。
  4. 创建 OAuth 2.0客户端ID 资格证书。
  5. 下载 client_secret_XXXXX.json 文件。

🔧 配置摘要

🔁 创建 config.py 包含以下内容:

import os

SCOPES = ["https://www.googleapis.com/auth/gmail.readonly"]
PROJECT_DIR = "/absolute/path/to/your/project/directory/"
CREDENTIALS_FP = os.path.join(PROJECT_DIR, "client_secret_XXXXX.json")
TOKEN_FP = os.path.join(PROJECT_DIR, "token.json")

注意:请确保替换上述代码中的占位符---PROJECT_DIR&CREDENTIALS_FP


🖥️ 3.克劳德桌面配置

在您的Claude Desktop配置文件中(可以在开发人员设置中找到):

{
  "mcpServers": {
    "EmailAssistant": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "yake",
        "--with",
        "google-api-python-client",
        "--with",
        "google-auth-httplib2",
        "--with",
        "google-auth-oauthlib",
        "mcp",
        "run",
        "/absolute/path/to/your/project/directory/main.py"
      ]
    }
  }
}

✅ 运行它

配置后:

  1. 启动克劳德桌面
  2. 克劳德将自动识别 EmailAssistant MCP服务器。
  3. 现在,您可以使用Claude调用以下函数:
get_email_summary(time="newer_than:1d")
get_top_matching_email(query_keywords="project deadline")
  1. 你所要做的就是用简单的英语问克劳德你的收件箱

📌 需求

  • Python 3.9+
  • uv (或使用 pip 如果不使用 uv)
  • 以下Python包:
    • google-api-python-client
    • google-auth-httplib2
    • google-auth-oauthlib
    • mcp[cli]