Google Workspace MCP Server
Overview
基本能力
产品定位
Google Workspace MCP Server 是一个专注于 Google Workspace 集成的服务，旨在通过自动化和管理工具提升用户在 Gmail、Google Calendar 和 Google Drive 上的工作效率。
核心功能
- Gmail 管理：
- 高级邮件搜索和过滤
- 邮件自动分类和标签管理
- 邮件草稿管理和发送
-
附件处理和元数据管理
-
Google Calendar 管理：
- 事件创建、修改和删除
- 事件响应管理（接受/拒绝邀请）
-
时间冲突检查和自动调度
-
Google Drive 管理：
- 文件上传、下载和搜索
- 文件夹创建和管理
-
文件权限和共享设置
-
账户管理：
- 多账户连接和认证
- 账户分类（工作/个人）
- 自动令牌刷新
适用场景
- 团队协作：管理团队邮件和日历事件，提升沟通效率。
- 个人生产力：自动化邮件分类和日历调度，减少手动操作。
- 文件管理：高效组织和共享 Google Drive 中的文件。
工具列表
- Account Management：
list_workspace_accounts：列出所有配置的 Google 账户。authenticate_workspace_account：添加和认证 Google 账户。-
remove_workspace_account：移除 Google 账户。 -
Gmail Operations：
search_workspace_emails：高级邮件搜索。send_workspace_email：发送邮件。-
manage_workspace_label：管理邮件标签。 -
Calendar Operations：
list_workspace_calendar_events：列出日历事件。-
create_workspace_calendar_event：创建新事件。 -
Drive Operations：
list_drive_files：列出文件。upload_drive_file：上传文件。
常见问题解答
- Missing Configuration：确保配置了 OAuth 凭证。
- Authentication Errors：检查 Google Cloud 项目配置和 API 启用状态。
- Token Issues：重新认证账户或检查 API 范围。
- Directory Structure：确保配置目录存在且 Docker 有访问权限。
使用教程
使用依赖
- 在 Google Cloud Console 创建项目。
- 启用以下 API：
- Gmail API
- Google Calendar API
- Google Drive API
- 配置 OAuth 同意屏幕并创建 OAuth 2.0 凭证。
安装教程
-
添加以下配置到 Cline MCP 设置文件：
json { "mcpServers": { "google-workspace-mcp": { "command": "docker", "args": [ "run", "--rm", "-i", "-v", "/home/aaron/.mcp/google-workspace-mcp:/app/config", "-e", "GOOGLE_CLIENT_ID", "-e", "GOOGLE_CLIENT_SECRET", "-e", "LOG_MODE=strict", "ghcr.io/aaronsb/google-workspace-mcp:latest" ], "env": { "GOOGLE_CLIENT_ID": "YOUR_CLIENT_ID", "GOOGLE_CLIENT_SECRET": "YOUR_CLIENT_SECRET" }, "autoApprove": [], "disabled": false } } } -
重启 Cline/Claude。
调试方式
-
运行以下命令手动启动容器：
bash docker run -i --rm \ -v ~/.mcp/google-workspace-mcp:/app/config \ -v ~/Documents/workspace-mcp-files:/app/workspace \ -e GOOGLE_CLIENT_ID=YOUR_CLIENT_ID \ -e GOOGLE_CLIENT_SECRET=YOUR_CLIENT_SECRET \ -e LOG_MODE=strict \ ghcr.io/aaronsb/google-workspace-mcp:latest -
检查日志输出以排查问题。