FindMCP Logo FindMCP.info
Gmail Sender MCP Server

Gmail Sender MCP Server

site icon
2025.04.16 0
Python邮件服务自动化工具交流协作
Gmail Sender MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，旨在为 Claude 和其他 AI 助手提供通过 Gmail API 发送电子邮件的功能。该服务专注于电子邮件发送能力，包括发送新邮件和回复现有邮件。它是一个轻量级且易于设置的工具，适用于需要自动化邮件发送的场景。
View on GitHub

Overview

基本能力

产品定位

Gmail Sender MCP Server 是一个专门为 AI 助手设计的邮件发送服务，通过 Gmail API 实现电子邮件的自动化发送和回复。

核心功能

  • 发送新邮件
  • 回复现有邮件

适用场景

  • AI 助手需要发送通知或回复邮件
  • 自动化工作流中需要邮件发送功能
  • 开发需要集成邮件发送能力的应用

工具列表

  • send_email 工具：发送新邮件，参数包括 to（收件人邮箱）、subject（邮件主题）、body（邮件内容，支持 HTML 格式）。
  • reply_to_email 工具：回复现有邮件，参数包括 email_id（邮件 ID）、body（回复内容，支持 HTML 格式）。

常见问题解答

  • 认证错误：检查 .env 文件中的凭证是否正确。
  • 权限错误：确认已在 Google Cloud 项目中启用 Gmail API。
  • 令牌过期：如果刷新令牌失效，使用辅助脚本重新生成。

使用教程

使用依赖

  • Python 3.8 或更高版本
  • 已启用 Gmail API 的 Google Cloud 账户
  • Docker（可选，用于容器化部署）

安装教程

  1. 克隆仓库：
git clone https://github.com/abhishekloiwal/gmail-sender-mcp.git
cd gmail-sender-mcp
  1. 安装依赖：
pip install -r requirements.txt
  1. 设置凭证：
  2. 将下载的凭证文件重命名为 credentials.json 并放入项目根目录。
  3. 运行辅助脚本获取刷新令牌：
python get_refresh_token.py
  • 复制终端中显示的刷新令牌。
  • 创建并编辑 .env 文件：
cp .env.example .env
  1. 运行 MCP 服务器：
python gmail_sender.py

Docker 部署

  1. 构建并运行 Docker 容器：
docker build -t gmail-sender-mcp .
docker run -d --name gmail-sender-mcp --env-file .env gmail-sender-mcp
  1. 或使用 Docker Compose：
docker-compose up -d

调试方式

  • 确保服务器已启动并监听连接。
  • 检查日志以确认无错误信息。

许可证

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