gsuite-mcp

🚀 Google 工作区 MCP 服务器

一个提供 Gmail 和日历 API 工具的 Model Context Protocol (MCP) 服务器，允许通过 MCP 接口对电子邮件和日历事件进行编程管理，极大提升了邮件和日历管理的便捷性与灵活性。

🚀 快速开始

该 Google 工作区 MCP 服务器可助力用户借助 MCP 接口对电子邮件和日历事件进行编程管理。在使用前，请确保满足先决条件并完成安装。

✨ 主要特性

邮件工具

• list_emails：列出收件箱中的近期邮件，支持可选过滤，方便您快速定位所需邮件。
• search_emails：使用 Gmail 查询语法进行高级邮件搜索，满足复杂的搜索需求。
• send_email：发送新邮件，支持 CC 和 BCC，使邮件发送更加灵活。
• modify_email：修改邮件标签（存档、删除、标记为已读/未读），轻松管理邮件状态。

日历工具

• list_events：列出即将进行的日历事件，可通过可选日期范围进行过滤，让您清晰掌握日程安排。
• create_event：创建新的日历事件，支持添加参与者，方便团队协作。
• update_event：更新现有日历事件，确保日程信息的准确性。
• delete_event：删除日历事件，灵活调整日程安排。

📦 安装指南

先决条件

1. Node.js：安装 Node.js 14 或更高版本。
2. Google Cloud Console 设置：
   • 前往 Google Cloud Console。
   • 创建新项目或选择现有项目。
   • 启用 Gmail API 和 Google Calendar API：
     1. 进入 "APIs & Services" > "Library"。
     2. 搜索并启用 "Gmail API"。
     3. 搜索并启用 "Google Calendar API"。
   • 设置 OAuth 2.0 凭证：
     1. 进入 "APIs & Services" > "Credentials"。
     2. 点击 "Create Credentials" > "OAuth client ID"。
     3. 选择 "Web 应用程序"。
     4. 设置 "Authorized redirect URIs" 包括：http://localhost:4100/code。
     5. 记下 Client ID 和 Client Secret。

安装方式

使用 Smithery 自动安装

通过 Smithery 自动安装：

$ npm install -g @rishipradeep-think41/gsuite-mcp

手动安装

手动下载并安装最新版本的 MCP 服务器：

1. 下载 latest.mcp。
2. 解压文件到目标目录。
3. 运行 start_server.sh 或 start_server.bat 启动服务器。

💻 使用示例

基础用法

邮件操作示例

{
  "command": "list_emails",
  "params": {
    "label": "INBOX",
    "maxResults": 10
  }
}

日历操作示例

{
  "command": "create_event",
  "params": {
    "summary": "会议",
    "location": "会议室 A",
    "start_time": "2024-01-24T10:00:00Z",
    "end_time": "2024-01-24T11:00:00Z"
  }
}

📚 详细文档

故障排除

身份验证问题

• 确保所有必需的 OAuth 作用域已授予。
• 验证客户端 ID 和密钥是否正确。
• 检查刷新令牌是否有效。

API 错误

• 在 Google Cloud Console 中检查 API 配额和限制。
• 确保 API 对您的项目已启用。
• 验证请求参数是否符合要求的格式。

📄 许可证

本项目采用 MIT 许可证授权。