Gmail AutoAuth MCP Server
2025.04.16
163
JavaScript邮件管理自动化工作流交流协作
Gmail AutoAuth MCP Server 是一个基于模型上下文协议（MCP）的服务，专为Claude Desktop设计，提供Gmail集成功能并支持自动认证。该服务器使AI助手能够通过自然语言交互管理Gmail，包括发送邮件、阅读邮件、搜索邮件、管理标签等完整功能。
View on GitHub
Overview
基本能力
产品定位
Gmail AutoAuth MCP Server 是一个Gmail集成服务，通过MCP协议为AI助手提供完整的Gmail管理能力。
核心功能
- 发送邮件（支持主题、内容、附件和收件人）
- 阅读邮件（支持高级MIME结构处理）
- 查看邮件附件信息（文件名、类型、大小）
- 搜索邮件（支持多种条件）
- 完整的标签管理（创建、更新、删除和列出标签）
- 列出收件箱、已发送或自定义标签中的邮件
- 标记邮件为已读/未读
- 将邮件移动到不同标签/文件夹
- 删除邮件
- 批量操作（高效处理多封邮件）
- 完整的Gmail API集成
- 简单的OAuth2认证流程（支持自动浏览器启动）
- 支持桌面和Web应用凭证
- 全局凭证存储
适用场景
- AI助手管理Gmail
- 批量邮件处理
- 自动化邮件工作流
- 邮件标签管理
工具列表
- 发送邮件 (
send_email): 立即发送新邮件 - 草拟邮件 (
draft_email): 创建草稿邮件而不发送 - 阅读邮件 (
read_email): 按ID检索特定邮件内容 - 搜索邮件 (
search_emails): 使用Gmail搜索语法搜索邮件 - 修改邮件 (
modify_email): 为邮件添加或删除标签 - 删除邮件 (
delete_email): 永久删除邮件 - 列出邮件标签 (
list_email_labels): 检索所有可用的Gmail标签 - 创建标签 (
create_label): 创建新的Gmail标签 - 更新标签 (
update_label): 更新现有Gmail标签 - 删除标签 (
delete_label): 删除Gmail标签 - 获取或创建标签 (
get_or_create_label): 按名称获取现有标签或创建新标签 - 批量修改邮件 (
batch_modify_emails): 高效批量修改多封邮件的标签 - 批量删除邮件 (
batch_delete_emails): 高效批量删除多封邮件
常见问题解答
- OAuth密钥未找到: 确保
gcp-oauth.keys.json在当前目录或~/.gmail-mcp/中 - 无效的凭证格式: 确保OAuth密钥文件包含
web或installed凭证 - 端口已被占用: 如果端口3000已被使用，请释放它
- 批量操作失败: 检查详细错误信息，考虑减少批量大小
使用教程
使用依赖
需要安装Node.js和npm
安装教程
通过Smithery安装
npx -y @smithery/cli install @gongrzhe/server-gmail-autoauth-mcp --client claude
手动安装
- 创建Google Cloud项目并获取凭证
- 运行认证
bash mkdir -p ~/.gmail-mcp mv gcp-oauth.keys.json ~/.gmail-mcp/ npx @gongrzhe/server-gmail-autoauth-mcp auth - 在Claude Desktop中配置
json { "mcpServers": { "gmail": { "command": "npx", "args": [ "@gongrzhe/server-gmail-autoauth-mcp" ] } } }
调试方式
运行认证后，可以使用以下命令测试功能:
npx @gongrzhe/server-gmail-autoauth-mcp list_email_labels