[WIP] Programmable Email

基本能力

产品定位

Programmable Email 是一个用于连接 Claude 与 Gmail 的 MCP 服务器，旨在通过 Gmail 的 API 实现电子邮件的读取和发送功能。

核心功能

• 连接 Claude 或任何 MCP 客户端与 Gmail
• 使用 Gmail 的本地 OAuth 令牌进行认证
• 读取最近的未读邮件（功能尚在开发中）
• 发送邮件（功能尚在开发中）

适用场景

• 实验和测试 Claude 与 Gmail 的集成
• 通过 Claude 自动化处理电子邮件

工具列表

• Gmail API：用于读取和发送电子邮件

常见问题解答

• 任何获取的电子邮件都会被发送到 Claude 的服务器，使用时需注意隐私问题。
• 目前仅支持部分搜索功能，完整功能尚在开发中。

使用教程

使用依赖

• Docker
• Claude Desktop for Mac

安装教程

1. 生成 Gmail OAuth 凭证 按照 Google 的指南 生成个人 OAuth 令牌。创建作为服务器端应用的 OAuth 客户端 ID 凭证。 在根目录下需要 credentials.json 和 token.json。token.json 会在首次使用 Google OAuth 凭证时自动生成。

2. 构建 Docker 镜像 运行以下命令构建镜像： bash docker build -t programmable-email . 验证镜像是否运行： bash docker run -i --rm programmable-email

3. 配置 Claude 与 MCP 服务器 进入 MCP 服务器配置目录： bash cd ~/Library/Application\ Support/Claude 编辑 claude_desktop_config.json 文件，添加以下内容： json { "mcpServers": { "programmable-email": { "command": "docker", "args": ["run", "-i", "--rm", "programmable-email"] } } }

4. 打开或重启 Claude

5. 让 Claude 获取最近的未读邮件

调试方式

• 运行 Docker 镜像并检查日志输出： bash docker run -i --rm programmable-email
• 检查 token.json 和 credentials.json 是否正确配置。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。