Gmail AutoAuth MCP Server

Overview

基本能力

产品定位

Gmail AutoAuth MCP Server 是一个用于在Claude Desktop中集成Gmail的Model Context Protocol (MCP)服务器，支持自动认证功能。该服务器使AI助手能够通过自然语言交互管理Gmail。

核心功能

发送带有主题、内容、附件和收件人的电子邮件
通过ID读取电子邮件
使用各种条件（主题、发件人、日期范围）搜索电子邮件
列出收件箱、已发送或自定义标签中的电子邮件
将电子邮件标记为已读/未读
将电子邮件移动到不同的标签/文件夹
删除电子邮件
完全集成Gmail API
简单的OAuth2认证流程，支持自动浏览器启动
支持桌面和Web应用程序凭据
全局凭据存储，方便使用

适用场景

通过AI助手管理Gmail
自动化电子邮件发送和接收
批量处理电子邮件
集成到其他应用程序中

工具列表

发送电子邮件
搜索电子邮件
读取电子邮件
移动电子邮件

常见问题解答

OAuth Keys Not Found
确保gcp-oauth.keys.json位于当前目录或~/.gmail-mcp/中
检查文件权限
Invalid Credentials Format
确保您的OAuth密钥文件包含web或installed凭据
对于Web应用程序，验证重定向URI是否正确配置
Port Already in Use
如果端口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
本地认证 bash npx @gongrzhe/server-gmail-autoauth-mcp auth
在Claude Desktop中配置

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "@gongrzhe/server-gmail-autoauth-mcp"
      ]
    }
  }
}

Docker支持

认证

docker run -i --rm \
  --mount type=bind,source=/path/to/gcp-oauth.keys.json,target=/gcp-oauth.keys.json \
  -v mcp-gmail:/gmail-server \
  -e GMAIL_OAUTH_PATH=/gcp-oauth.keys.json \
  -e "GMAIL_CREDENTIALS_PATH=/gmail-server/credentials.json" \
  -p 3000:3000 \
  mcp/gmail auth

使用

{
  "mcpServers": {
    "gmail": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "mcp-gmail:/gmail-server",
        "-e",
        "GMAIL_CREDENTIALS_PATH=/gmail-server/credentials.json",
        "mcp/gmail"
      ]
    }
  }
}

调试方式

检查认证文件是否正确放置
检查端口3000是否可用
检查OAuth凭据是否正确配置

许可证

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