FindMCP Logo FindMCP.info
Google Workspace MCP Server

Google Workspace MCP Server

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

Overview

基本能力

产品定位

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

核心功能

  • Gmail工具
  • list_emails: 列出收件箱中的最近邮件，支持过滤
  • search_emails: 使用Gmail查询语法进行高级邮件搜索
  • send_email: 发送新邮件，支持CC和BCC

  • modify_email: 修改邮件标签（归档、标记已读/未读等）

  • Calendar工具

  • list_events: 列出即将到来的日历事件，支持日期范围过滤
  • create_event: 创建新的日历事件，支持添加参与者
  • update_event: 更新现有的日历事件
  • delete_event: 删除日历事件

适用场景

  • 自动化邮件管理（如批量处理未读邮件）
  • 日程自动化（如批量创建或更新会议）
  • 团队协作中的邮件和日程自动化

工具列表

  • Gmail工具：提供邮件列表、搜索、发送和修改功能
  • Calendar工具：提供事件列表、创建、更新和删除功能

常见问题解答

  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文件

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

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

  5. 构建并运行 bash npm run build

调试方式

  1. Gmail操作
  2. 列出最近邮件
  3. 搜索邮件
  4. 发送邮件

  5. 修改邮件

  6. Calendar操作

  7. 列出事件
  8. 创建事件
  9. 更新事件
  10. 删除事件

许可证

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