Google 工作区 MCP 服务器

一个提供 Gmail 和日历 API 工具的 Model Context Protocol (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 对您的项目已启用
   • 验证请求参数是否符合要求的格式

许可证

本项目licensed under the MIT License。