Gmail MCP 服务器

Gmail MCP 服务器

用于集成 Gmail 的 Model Context Protocol (MCP) 服务器,支持发送、读取和管理邮件。

快速入门

  1. 设置 Gmail API

    • 创建 Google Cloud 项目并启用 Gmail API。
    • 配置 OAuth 同意屏幕,添加作用域 https://www.googleapis.com/auth/gmail/modify
    • 下载 OAuth 客户端 JSON 文件并保存为 client_creds.json
  2. 运行服务器

    • 使用 uv 工具运行: uv run gmail --creds-file-path /path/to/client_creds.json --token-path /path/to/app_tokens.json
    • 第一次运行会启动浏览器完成身份验证。
  3. 测试功能

    • 使用 MCP Inspector 测试: npx @modelcontextprotocol/inspector uv run /path/to/server.py 参数同上
  4. 主要功能

    • 发送邮件:send-email
    • 删除邮件:trash-email
    • 标记已读:mark-email-as-read
    • 获取未读邮件:get-unread-emails
    • 读取邮件内容:read-email
    • 在浏览器中打开邮件:open-email