Gmail Plugin MCP Server

Gmail Plugin MCP 服务

一个功能强大的 MCP 服务，可集成 Gmail，让你通过 MCP 客户端直接管理邮件。此插件可无缝访问 Gmail 的核心功能，包括读取、发送和管理邮件。

参考：如需查看使用 uvx 实现的 MCP 服务示例，请参阅此示例。

🎥 演示

https://github.com/user-attachments/assets/df9e86cf-1f6b-4265-9c68-b3ed88103d1f

✨ 功能

• 📧 收发邮件
• 📥 阅读未读邮件
• 🗑️ 将邮件移至垃圾箱
• 📱 在浏览器中打开邮件
• 📝 将邮件标记为已读
• 🔒 安全的 OAuth2 身份验证

🚀 快速开始

前置条件

• Python 3.12 或更高版本
• Gmail API 凭据
• MCP 客户端（例如 Claude Desktop）

安装

1. 克隆仓库：

git clone https://github.com/yourusername/gmail-plugin.git
cd gmail-plugin

2. 安装依赖项（任选一种方式）：

# Method 1: Install in editable mode
uv pip install -e .

# Method 2: Install using requirements.txt
uv pip install -r requirements.txt

# Method 3: Install using uv sync (recommended)
uv sync --dev --all-extras

3. 配置 Gmail API 凭据：
   • 前往 Google Cloud Console
   • 创建新项目，或选择现有项目
   • 启用 Gmail API
   • 配置 OAuth 同意屏幕：
     • 选择“External”用户类型（无需发布）
     • 前往 Audiences 标签页：将你的邮箱添加为“Test user”
     • 添加 OAuth 范围：https://www.googleapis.com/auth/gmail/modify
   • 创建 OAuth 2.0 凭据：
     • 将应用类型设为“Desktop App”
     • 下载 JSON 凭据文件
   • 保存凭据文件并记下其绝对路径（将在 --creds-file-path 中使用）

配置

用于开发／未发布的服务

将以下内容添加到 MCP 客户端配置中：

"mcpServers": {
  "gmail-plugin": {
    "command": "uv",
    "args": [
      "--directory",
      "[absolute path to working directory]",
      "run",
      "server.py"
      "--creds-file-path",
      "[absolute-path-to-credentials-file]",
      "--token-path",
      "[absolute-path-to-access-tokens-file]"
    ]
  }
}

用于已发布的服务

"mcpServers": {
  "gmail-plugin": {
    "command": "uvx",
    "args": [
      "gmail-plugin"
    ]
  }
}

🛠️ 开发

构建和发布

1. 同步依赖项：

uv sync

2. 构建软件包：

uv build

3. 发布到 PyPI：

uv publish

调试

使用 MCP Inspector 进行调试：

npx @modelcontextprotocol/inspector uv --directory C:\Users\sanch\Desktop\gmail_plugin\gmail-plugin run gmail-plugin

📚 API 参考

可用工具

工具名称	描述	必需参数
send-email	发送邮件	recipient_id, subject, message
get-unread-emails	获取未读邮件	无
read-email	阅读邮件内容	email_id
trash-email	将邮件移至垃圾箱	email_id
mark-email-as-read	将邮件标记为已读	email_id
open-email	在浏览器中打开邮件	email_id

可用提示词

提示词名称	描述	参数
manage-email	作为邮件管理员执行操作	无
draft-email	起草新邮件	content, recipient, recipient_email
edit-draft	编辑现有邮件草稿	changes, current_draft

🤝 参与贡献

欢迎贡献！请随时提交 Pull Request。

📄 许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。