AI导哈

Gmail邮件服务器

一个使用模型上下文协议读取和创建Gmail邮件草稿的服务器。

  • by VatsKan
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 VatsKan/mcp-gmail-server

使用说明

MCP Gmail服务器

使用模型上下文协议的服务器[https://modelcontextprotocol.io/]阅读和创建来自Gmail的电子邮件草稿。

项目设置

创建Oauth客户端并添加secrets：

创建谷歌云项目

  1. 首选 https://console.cloud.google.com/
  2. 在左上角，打开项目下拉列表并单击 新项目
  3. 为您的项目命名（例如。， Gmail API演示)
  4. 点击 创建 您的项目现在已创建；确保在项目下拉列表中选中它。

启用Gmail API

  1. 转到 API库: https://console.cloud.google.com/apis/library
  2. 搜索 Gmail API
  3. 点击它→ 启用

配置OAuth 2.0凭据

  1. 导航到： API和服务→ 凭证

  2. 系统将提示您配置 OAuth同意屏幕 （如果第一次创建OAuth凭据）

  3. 选择 外部 如果您的Google工作区之外的用户将使用它

  4. 填写详细信息

  5. 添加测试用户（开发期间允许授权的电子邮件地址）

  6. 保存配置

  7. 点击 创建凭证 → OAuth客户端ID

  8. 选择应用程序类型： 桌面应用程序 （用于测试/开发）

  9. 说出它的名字

  10. 点击 创建

您现在将收到：

  • 客户端ID
  • 客户端密钥 将它们下载为JSON格式，以便在代码中使用。

将JSON另存为 此项目根目录中的“client_secret_auth_gcp.json”。 （请注意，这应该安全地存储，不要提交到github。）

安装并运行应用程序

安装紫外线： https://docs.astral.sh/uv/getting-started/installation/

使用uv安装依赖项： uv sync

启动服务器： uv run -m src.mcp_server_gmail

克劳德桌面

安装克劳德桌面

集 claude_desktop_config.json 文件到：

{
  "mcpServers": {
    "gmail": {
      "command": "/Users/myname/Documents/Coding/fac-mcp-gmail-server/.venv/bin/python",
      "args": [
        "-m",
        "mcp_server_gmail"
      ],
      "env": {
        "PYTHONPATH": "/Users/myname/Documents/Coding/fac-mcp-gmail-server/src"
      },
      "cwd": "/Users/myname/Documents/Coding/fac-mcp-gmail-server"
    }
  }
}

确保用本地目录路径适当替换目录路径。

测试（手动）

转到claude桌面

尝试以下操作： “获取最后3封未读电子邮件” “为这些创建电子邮件草稿”

看 /docs/working_examples，例如mcp服务器的屏幕截图

特性

  • Gmail Oauth设置
  • 用于在gmail上阅读和起草电子邮件的MCP服务器

相关 MCP