JinDaGe - programmable-email MCP Details

article

README

🚀 [WIP] 可编程电子邮件

本项目提供了一个MCP服务器，用于连接Claude与Gmail，借助Gmail的本地OAuth令牌实现二者的通信。该服务器主要用于实验和测试，不过需要注意的是，获取的所有邮件都会发送到Claude的服务器。

🚀 快速开始

此服务器将Claude（或任何MCP客户端）与Gmail相连，利用Gmail的本地OAuth令牌实现通信。不过要留意，获取的所有邮件都会被发送到Claude的服务器。

✨ 主要特性

实现Claude与Gmail的连接，使用Gmail的本地OAuth令牌。
专为实验和测试目的设计。

📦 安装指南

1. 准备工作

安装Docker
安装Mac版Claude桌面

2. 获取Gmail OAuth凭证

首先，您需要生成个人OAuth令牌，请按照此指南操作，创建一个服务器端应用的OAuth客户端ID凭证。

您需要在根目录下准备好两个文件：

credentials.json：代表Google的OAuth令牌。
token.json：该文件会在第一次使用Google OAuth凭证时自动生成。

3. 构建Docker镜像

通过以下命令构建镜像：

docker build -t programmable-email .

确认镜像是否正常运行：

docker run -i --rm programmable-email

4. 配置Claude以连接MCP服务器

访问MCP服务器配置所在的目录：

cd ~/Library/Application\ Support/Claude

编辑claude_desktop_config.json文件，添加以下内容：

{
    "mcpServers": {
        "programmable-email": {
            "command": "docker",
            "args": ["run", "-i", "--rm", "programmable-email"]
        }
    }
}

5. 打开（或重启）Claude

6. 让Claude获取您最近的未读邮件。

📄 待办事项

完成Gmail阅读功能（目前仅实现了部分可用搜索功能，见index.ts）
实现Gmail发送功能（参见gmail_api.ts中的能力）
进行更多测试

programmable-email