Google Workspace MCP

谷歌工作区MCP

一个模型上下文协议（MCP）服务器，用于通过统一界面与谷歌工作区服务（Gmail、日历、驱动器）进行交互。

特性

Gmail

• 电子邮件管理：发送、接收、列出、搜索和获取电子邮件
• 标签/文件夹：创建、更新、删除和组织带有标签的电子邮件
• 电子邮件操作：标记为已读/未读、星号/取消星号、存档、垃圾箱、删除
• 附件：下载电子邮件附件
• 过滤器：创建和管理电子邮件过滤器/规则
• 联系人：列出、搜索、创建、更新和删除联系人
• 多账户：支持多个Gmail帐户

日历

• 日历管理：列出、创建、更新和删除日历
• 活动操作：创建、更新、删除、搜索和快速添加事件
• 重复事件：创建重复事件、修改单个实例、删除未来事件
• 活动互动：回复邀请、管理提醒、添加Google Meet会议
• 可用性：检查忙/闲状态，查找多个与会者的可用时间段

驾驶

• 文件管理：列出文件和文件夹，获取文件元数据，浏览文件夹内容
• 创建并上传：创建文件夹、仅创建元数据文件和上传文件内容
• 文件传输：在文件夹之间移动文件以及下载/导出文件

安装

go install github.com/jingkaihe/google-workspace-mcp/cmd/google-workspace-mcp@latest

或者从源代码构建：

git clone https://github.com/jingkaihe/google-workspace-mcp
cd google-workspace-mcp
go build -o bin/google-workspace-mcp ./cmd/google-workspace-mcp

设置

1.获取Google OAuth凭据

1. 去 谷歌云控制台
2. 创建新项目或选择现有项目
3. 启用Gmail API、People API、Google Calendar API和Google Drive API
4. 转到“凭据”→ “创建凭据”→ “OAuth客户端ID”
5. 选择“桌面应用程序”作为应用程序类型
6. 下载凭据并另存为 credentials.json

2.初始化帐户

放置 credentials.json 当前目录中的文件或 ~/.config/google-workspace-mcp/，然后运行：

google-workspace-mcp account add

这将：

1. 显示授权URL
2. 您在浏览器中打开它并授权应用程序
3. 将重定向URL复制回CLI
4. 存储刷新令牌以备将来使用

3.配置MCP客户端

添加到您的MCP客户端配置中（例如，Claude Desktop）：

{
  "mcpServers": {
    "google-workspace": {
      "command": "google-workspace-mcp",
      "args": []
    }
  }
}

CLI命令

能力标志

这 --capabilities 标志允许您启用特定功能：

# Default: all capabilities enabled
google-workspace-mcp

# Enable specific capabilities only
google-workspace-mcp --capabilities=gmail
google-workspace-mcp --capabilities=calendar
google-workspace-mcp --capabilities=drive
google-workspace-mcp --capabilities=gmail,calendar,drive

优点：

• 最小权限原则：只启用所需的功能
• 减少OAuth范围请求：授权过程中的权限占用较小
• 刀具表面更小：MCP客户端需要处理的工具更少
• 更容易调试：专注于特定功能

可用的MCP工具

电子邮件操作

电子邮件操作

标签

附件

过滤器

联系人

日历管理

活动操作

活动互动

重复事件

可用性和调度

驾驶操作

Gmail搜索查询语法

使用时 gmail_list_emails 或 gmail_search_emails，您可以使用Gmail的搜索运营商：

联合操作员： from:boss@company.com is:unread has:attachment

配置

配置和令牌存储在：

• ~/.config/google-workspace-mcp/tokens.json -连接帐户的OAuth令牌
• ~/.config/google-workspace-mcp/credentials.json -（可选）OAuth凭据

需要OAuth作用域

• gmail.GmailReadonlyScope -阅读电子邮件
• gmail.GmailSendScope -发送电子邮件
• gmail.GmailModifyScope -修改电子邮件（标签、已读/未读）
• gmail.GmailLabelsScope -管理标签
• gmail.GmailSettingsBasicScope -管理筛选器
• people.ContactsScope -完整联系人访问权限
• people.ContactsReadonlyScope -读取联系人
• calendar.CalendarScope -完全访问日历
• calendar.CalendarEventsScope -访问日历事件
• drive.DriveScope -完全访问驱动器文件和文件夹

安全

• OAuth令牌以受限权限安全地存储在您的主目录中（0600）
• 刷新令牌用于保持持久访问，而不存储密码
• 应用程序仅请求启用功能所需的OAuth作用域

许可证

麻省理工学院