Google Workspace MCP Server

基本能力

产品定位

Google Workspace MCP Server 是一个集成 Google Workspace 功能的 MCP 服务器，主要用于邮件和日历管理。

核心功能

• Gmail 功能
• list_emails: 列出收件箱中的邮件，支持过滤
• search_emails: 使用 Gmail 查询语法搜索邮件
• send_email: 发送邮件，支持 CC 和 BCC

• modify_email: 管理邮件标签（归档、标记为已读/未读等）

• 日历功能

• list_events: 列出指定日期范围内的事件
• create_event: 创建包含参与者的事件
• update_event: 更新现有事件
• delete_event: 删除事件

适用场景

• 团队协作中的邮件和日程管理
• 自动化邮件处理和日历事件管理
• 集成到现有工作流中，提高效率

工具列表

• get-refresh-token.js: 用于获取 Google OAuth 的刷新令牌
• npm scripts: 包括构建、启动、清理、部署和日志查看等命令

常见问题解答

1. 认证问题
2. 确保 OAuth 范围正确
3. 检查 Client ID 和 Secret 是否正确
4. 确认刷新令牌有效
5. API 错误
6. 检查 Google Cloud Console 中的 API 配额和限制
7. 确认项目已启用相关 API
8. 检查请求参数格式是否正确

使用教程

使用依赖

1. Node.js: 安装 Node.js 20 或更高版本
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/Yulikepython/gogole-workspace-mcp-server-by-itc.git cd google-workspace-mcp-server-by-itc npm install
2. 设置认证信息 bash cp credentials.json.example credentials.json 编辑 credentials.json 文件，填入你的 Client ID 和 Client Secret
3. 获取刷新令牌 bash node get-refresh-token.js
4. 配置 MCP 设置 在 MCP 配置文件中添加服务器设置
5. 构建和运行 bash npm run build
6. 部署设置 bash cp .env.example .env 编辑 .env 文件，设置 SSH 相关环境变量

调试方式

• 使用 npm run start 在本地运行服务器
• 使用 npm run logs 查看实时日志

许可证

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