Google Workspace MCP Server

基本能力

产品定位

Google Workspace MCP Server 是一个用于与 Google Workspace 服务（如 Gmail 和 Calendar）交互的中间件服务，通过 MCP 接口提供编程访问能力。

核心功能

1. Gmail 工具
2. list_emails: 列出收件箱中的最近邮件，支持过滤
3. search_emails: 使用 Gmail 查询语法进行高级邮件搜索
4. send_email: 发送新邮件，支持 CC 和 BCC

5. modify_email: 修改邮件标签（归档、删除、标记已读/未读）

6. Calendar 工具

7. list_events: 列出即将到来的日历事件，支持日期范围过滤
8. create_event: 创建新的日历事件，支持添加参与者
9. update_event: 更新现有的日历事件
10. delete_event: 删除日历事件

适用场景

• 自动化邮件处理
• 批量管理日历事件
• 集成 Google Workspace 功能到其他应用中

工具列表

1. Gmail 工具
2. list_emails: 列出邮件
3. search_emails: 搜索邮件
4. send_email: 发送邮件

5. modify_email: 修改邮件状态

6. Calendar 工具

7. list_events: 列出事件
8. create_event: 创建事件
9. update_event: 更新事件
10. delete_event: 删除事件

常见问题解答

1. 认证问题
2. 确保所有必需的 OAuth 范围已授权
3. 验证客户端 ID 和密钥是否正确

4. 检查刷新令牌是否有效

5. API 错误

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

使用教程

使用依赖

1. Node.js: 安装 Node.js 14 或更高版本
2. Google Cloud Console 设置
3. 访问 Google Cloud Console
4. 创建新项目或选择现有项目
5. 启用 Gmail API 和 Google Calendar API
6. 设置 OAuth 2.0 凭据

安装教程

1. 克隆并安装 bash git clone https://github.com/epaproditus/google-workspace-mcp-server.git cd google-workspace-mcp-server npm install

2. 创建 OAuth 凭据 在根目录创建 credentials.json 文件

3. 获取刷新令牌 bash node get-refresh-token.js

4. 配置 MCP 设置 将服务器配置添加到 MCP 设置文件中

5. 构建并运行 bash npm run build

调试方式

1. Gmail 操作
2. 列出最近邮件
3. 搜索邮件
4. 发送邮件

5. 修改邮件

6. Calendar 操作

7. 列出事件
8. 创建事件
9. 更新事件
10. 删除事件

许可证

该项目遵循 MIT 开源许可条款。