邮件处理服务

一个基于Gmail API的MCP服务器,提供未读邮件检索和草稿回复创建功能,适用于本地运行的Claude Desktop扩展。

  • by loiswells97
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 loiswells97/draft-email-mcp

使用说明

起草电子邮件mcp

MCP服务器,用于检索未读电子邮件并通过Gmail API创建草稿回复

概述

此MCP服务器设计为使用Claude Desktop在本地运行。它通过提供以下附加能力扩展了LLM的能力:

  • 检索最新 n 来自经过身份验证的Gmail收件箱的未读电子邮件
  • 在给定相关条件的情况下,在Gmail中为电子邮件创建草稿回复 email_id
  • 检索本地电子邮件样式指南文件

设置

先决条件

  • 具有Gmail API访问权限的Google Cloud项目的凭据
  • Claude Desktop已在本地安装

环境变量

  • 克隆 .env.example 变成新鲜的 .env 文件
  • 下载 credentials.json 为您的Google Cloud项目创建文件,并将其放置在方便的位置
  • 设置 GOOGLE_CREDENTIALS_PATH 在 .env 指向你的 credentials.json 文件
  • 设置 GOOGLE_TOKEN_PATH 到所需的位置 token.json。这需要是一个可写目录,因为当服务器使用Google Auth进行身份验证时,将创建令牌文件。
  • 如果提供本地电子邮件样式指南,请设置 EMAIL_STYLE_GUIDE_PATH 可变到样式指南的位置。看 example_email_style_guide.md 例如风格指南。

设置 claude_desktop_config.json

  • 找到 claude_desktop_config.json:
    • 雨衣: /Users/{user}/Library/Application Support/Claude/claude_desktop_config.json
    • 窗户: %APPDATA%\Claude\claude_desktop_config.json
  • 扩展您现有的 claude_desktop_config.json 具有以下配置:
    {
      "mcpServers": {
        "email": {
          "command": "{path-to-your-draft-email-mcp-directory}/env/bin/python",
          "args": ["{path-to-your-draft-email-mcp-directory}/draft_email_server.py"],
          "env": {}
        }
      }
    }
    

启动服务器

  • 打开Claude Desktop,MCP服务器应自动启动

使用Google进行身份验证

  • 当第一次请求MCP服务器需要Gmail API访问时,系统将提示您向Google进行身份验证。一旦完成,你就可以走了! 🚀

可用工具

此MCP服务器提供以下工具:

get_unread_emails

这接受了a limit 默认为的论点 5 以确保该工具在与有大量未读电子邮件的收件箱一起使用时具有弹性。它检索 id, sender, subject, thread_id, timestamp 和 snippet 从Gmail收件箱中提取每封电子邮件,并以JSON格式返回结果。尽管在某些情况下检索电子邮件正文可能更好 1MB Claude Desktop施加的大小限制意味着许多包含大量图像的营销电子邮件太大,导致错误。

create_draft_reply

这接受了 email_id 原始电子邮件和 reply_body 作为字符串,并在Gmail的相关线程中创建草稿。它返回 draft_id 和 draft_message 以JSON格式创建的草稿。

get_style_guide

这将检索以下位置的样式指南内容 EMAIL_STYLE_GUIDE_PATH 让克劳德写更好的电子邮件。

演示

此演示使用 example_email_style_guide.md 作为风格指南。

示例提示

  • Summarise my last unread email
  • Create draft replies for my latest 3 unread emails
  • Get my email style guide

截图

之前

在...期间

之后