FindMCP Logo FindMCP.info
Google Workspace MCP Server

Google Workspace MCP Server

site icon
2025.05.01 0
JavaScript邮件管理日历管理交流协作日程管理
Google Workspace MCP Server 是一个基于模型上下文协议（MCP）的服务，主要用于与Gmail和Calendar API进行交互。通过该服务，用户可以编程方式管理电子邮件和日历事件。核心功能包括邮件列表、搜索、发送和修改，以及日历事件的创建、更新和删除。适用于需要自动化管理邮件和日程的个人或团队。
View on GitHub

Overview

基本能力

产品定位

Google Workspace MCP Server 是一个用于自动化管理Gmail和Google Calendar的工具，通过MCP接口提供编程式访问。

核心功能

  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. 创建或选择项目
  4. 启用Gmail API和Google Calendar API
  5. 设置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文件并填写客户端ID和密钥。

  3. 获取刷新令牌 bash node get-refresh-token.js

  4. 配置MCP设置 将服务器配置添加到MCP设置文件中。

  5. 构建并运行 bash npm run build

调试方式

  1. 认证调试
  2. 检查token.json文件是否存在且有效

  3. 验证OAuth流程是否完整

  4. API调试

  5. 使用示例请求测试各个功能
  6. 检查返回的错误信息以定位问题

许可证

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