🚀 [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中的能力） - 进行更多测试