Google Workspace MCP Server

基本能力

产品定位

Google Workspace MCP Server 旨在为开发者提供通过 MCP 接口管理 Gmail 和 Google Calendar 的能力，实现电子邮件和日历事件的自动化管理。

核心功能

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: 删除日历事件

适用场景

• 自动化邮件管理（如批量处理未读邮件）
• 自动化日历管理（如批量创建或更新会议）
• 集成到其他应用中实现邮件和日历的自动化操作

工具列表

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. 检查认证流程
2. 确保 credentials.json 和 token.json 文件正确配置

3. 验证 OAuth 流程是否成功完成

4. 测试 API 调用

5. 使用提供的示例 JSON 测试 Gmail 和 Calendar 操作

6. 检查返回结果是否符合预期

7. 查看日志

8. 运行服务时查看控制台输出，排查错误信息

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。