Gmail MCP Server

基本能力

产品定位

MCP-email-server 是一个桥接 Claude AI 与 Gmail API 的服务，使 Claude 能够执行认证的 Gmail 操作，同时保持安全性和隐私性。

核心功能

• 电子邮件操作：发送、回复、转发、读取和搜索电子邮件。
• 草稿管理：创建、更新、列出和发送草稿。
• 标签管理：创建、更新、删除和管理电子邮件标签。
• 附件管理：列出和保存电子邮件附件。
• 时区支持：显示和查询电子邮件时区信息。

适用场景

• 通过 Claude AI 自动化处理电子邮件任务。
• 管理多个电子邮件账户和标签。
• 安全地保存和处理电子邮件附件。

工具列表

• send_email：发送新电子邮件。
• reply_all_email：回复所有原始收件人。
• forward_email：转发电子邮件。
• list_send_as_accounts：列出所有可用的发送账户。
• get_recent_emails：获取最近的电子邮件。
• read_email：读取特定电子邮件。
• search_emails：搜索电子邮件。
• list_labels：列出所有标签。
• create_label：创建新标签。
• update_label：更新标签。
• delete_label：删除标签。
• mark_as_read：标记邮件为已读。
• mark_as_unread：标记邮件为未读。
• archive_message：归档邮件。
• unarchive_message：取消归档邮件。
• trash_message：将邮件移至垃圾箱。
• create_draft：创建草稿。
• get_draft：获取草稿内容。
• list_drafts：列出所有草稿。
• update_draft：更新草稿内容。
• delete_draft：删除草稿。
• send_draft：发送草稿。
• get_timezone_info：获取时区信息。
• list_attachments：列出附件。
• save_attachment：保存附件。

使用教程

使用依赖

• Node.js 16 或更高版本
• npm

安装教程

1. 创建 Google Cloud 项目并启用 Gmail API：
2. 访问 Google Cloud Console
3. 创建新项目
4. 启用 Gmail API
5. 创建 OAuth 凭据（桌面应用程序）

6. 下载凭据 JSON 文件为 gcp-oauth.keys.json

7. 克隆并安装： bash git clone https://github.com/cristip73/MCP-email-server.git cd MCP-email-server npm install

8. 构建服务器： bash npm run build

9. 与 Gmail 认证： bash npm run auth

10. 使包可用于 Claude： bash npm link

调试方式

1. 配置 Claude Desktop：
2. 进入 Claude Desktop 设置
3. 进入开发者模式

4. 编辑配置文件

5. 示例配置： json { "mcpServers": { "email-server": { "command": "node", "args": ["/path/to/email-server/build/index.js"], "env": { "TIME_ZONE": "GMT+2", "DEFAULT_ATTACHMENTS_FOLDER": "/Users/username/CLAUDE/Attachments" } } } }

6. 验证时区配置： bash npm run get_timezone_info

许可证

该项目遵循 MIT 开源许可条款。