MCP Google Workspace Server
2025.04.01
7
TypeScript邮件服务日历服务交流协作日程管理
MCP Google Workspace Server 是一个基于 Model Context Protocol 的服务器，用于与 Google Workspace 服务（如 Gmail 和 Google Calendar）进行交互。该服务器支持多账户管理、邮件查询与处理、日历事件管理等功能，适用于需要自动化处理邮件和日程的场景。
View on GitHub
Overview
基本能力
产品定位
MCP Google Workspace Server 是一个用于与 Google Workspace 服务交互的 MCP 协议服务器，主要提供 Gmail 和 Google Calendar 的集成功能。
核心功能
- 多账户支持：支持使用和切换多个 Google 账户，每个账户可配置自定义元数据和描述。
- Gmail 集成：
- 高级邮件搜索
- 邮件内容与附件读取
- 草稿创建与管理
- 邮件回复与归档
- 附件处理与批量操作
- Calendar 集成：
- 日历列表查看
- 事件创建与删除
- 多日历支持
- 自定义时区支持
适用场景
- 自动化邮件处理（如自动回复、邮件归档）
- 日程管理（如事件创建、时间安排）
- 多账户邮件与日历的统一管理
工具列表
- 账户管理工具：
gmail_list_accounts,calendar_list_accounts - Gmail 工具：
gmail_query_emails,gmail_get_email,gmail_create_draft,gmail_reply,gmail_get_attachment等 - Calendar 工具：
calendar_list,calendar_get_events,calendar_create_event,calendar_delete_event等
常见问题解答
- 如何配置 OAuth 2.0 认证？
- 需要在 Google Cloud Console 中创建 OAuth 2.0 凭证并启用 Gmail 和 Calendar API。
- 如何添加多个账户？
- 在
.accounts.json文件中配置多个账户信息。 - 如何启动服务器？
- 使用
npm start命令启动服务器。
使用教程
使用依赖
- Node.js >= 18
- Google Cloud 项目（已启用 Gmail 和 Calendar API）
- OAuth 2.0 凭证
安装教程
- 克隆仓库：
bash git clone https://github.com/j3k0/mcp-google-workspace.git cd mcp-google-workspace - 安装依赖：
bash npm install - 构建 TypeScript 代码：
bash npm run build
调试方式
- 启动服务器：
bash npm start - 检查 OAuth 2.0 认证是否成功。
- 使用工具命令测试功能（如
gmail_query_emails或calendar_get_events）。