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

1. 搜索 Gmail API
2. 点击它→ 启用

配置OAuth 2.0凭据

1. 导航到：

API和服务→ 凭证

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

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

1. 填写详细信息

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

1. 保存配置

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

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

1. 说出它的名字

1. 点击 创建

您现在将收到：

• 客户端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服务器