Gmail邮件发送服务

Gmail MCP服务器

此MCP（模型上下文协议）服务器为gmail的常见操作提供了工具。

特性

• send_mail：发送新电子邮件

先决条件

1. Python 3.12+
2. 紫外线 -快速Python包安装程序和解析器
3. 谷歌云控制台设置

• 首选 谷歌云控制台
• 为此MCP服务器创建新项目
• 启用Gmail API
  • 首选 API和服务>库
  • 搜索： Gmail API
  • 点击： Gmail API 结果中的瓷砖
  • 点击： 启用
• 设置OAuth
  • 首选 API和服务>凭据
  • 点击“： 创建凭据>OAuth客户端ID
  • 选择应用程序类型： Web应用程序
  • 添加： 授权重定向URI: http://localhost:4321/
  • 创建客户端
  • 下载JSON并保存到 credentials.json 在这个项目根。这有 客户端ID, 客户端密钥等等。

安装

1. 克隆此存储库：

   复制

   git clone https://github.com/heuristech/gmail-mcp-server.git
   cd gmail-mcp-server
   

2. 创建虚拟环境并在开发模式下安装软件包：

   复制

   # Create a virtual environment
   uv venv
   
   # Activate the virtual environment
   # On macOS/Linux:
   source .venv/bin/activate
   # On Windows:
   .venv\Scripts\activate
   
   # Install dependencies
   uv sync
   

获取刷新令牌

python get_refresh_token.py

这将：

1. 在上启动服务器 port: 4321 接收 tokens 发布谷歌OAuth
2. 打开Google OAuth浏览器
3. 成功通过身份验证后，它将保存 token.json 随着 refresh_token 连同 client_id，以及 client_secret.
4. 它还将显示 refresh_token 在控制台上。

检查

使用MCP检查器在开发模式下对其进行测试。

mcp dev server.py

Claude桌面集成

服务器准备就绪后，将其安装在Claude Desktop中

mcp install server.py --with google-auth --with google-auth-oauthlib --with google-auth-httplib2 --with google-api-python-client -f .env

MCP服务器配置：

{
  "mcpServers": {
    "gmail-mcp-server": {
      "command": "uv",
      "args": [
          "--directory",
          "/:your.path.to/gmail-mcp-server/server.py",
          "run",
          "server.py"
      ],
      "env": {
        "CLIENT_ID": "google.auth.app.client.id",
        "CLIENT_SECRET": "google.auth.app.client.secret",
        "REFRESH_TOKEN": "google.auth.app.refresh.token"
      }   
    }   
  }
}