🚀 Google 工作区 MCP 服务器

一个提供 Gmail 和日历 API 工具的 Model Context Protocol (MCP) 服务器，允许通过 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"
  }
}

📚 详细文档

故障排除

1. 身份验证问题：

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

2. API 错误：

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

📄 许可证

本项目采用 MIT 许可证。