Gsuite Mcp

日程官方认证远程 JavaScript

🚀 Google 工作区 MCP 服务器

一个提供 Gmail 和日历 API 工具的 Model Context Protocol (MCP) 服务器，允许通过 MCP 接口对电子邮件和日历事件进行编程管理，极大提升了邮件和日历管理的便捷性与灵活性。

🚀 快速开始

该 Google 工作区 MCP 服务器可助力用户借助 MCP 接口对电子邮件和日历事件进行编程管理。在使用前，请确保满足先决条件并完成安装。

✨ 主要特性

邮件工具

list_emails：列出收件箱中的近期邮件，支持可选过滤，方便您快速定位所需邮件。
search_emails：使用 Gmail 查询语法进行高级邮件搜索，满足复杂的搜索需求。
send_email：发送新邮件，支持 CC 和 BCC，使邮件发送更加灵活。
modify_email：修改邮件标签（存档、删除、标记为已读/未读），轻松管理邮件状态。

日历工具

list_events：列出即将进行的日历事件，可通过可选日期范围进行过滤，让您清晰掌握日程安排。
create_event：创建新的日历事件，支持添加参与者，方便团队协作。
update_event：更新现有日历事件，确保日程信息的准确性。
delete_event：删除日历事件，灵活调整日程安排。

📦 安装指南

先决条件

Node.js：安装 Node.js 14 或更高版本。
Google Cloud Console 设置：
- 前往 Google Cloud Console。
- 创建新项目或选择现有项目。
- 启用 Gmail API 和 Google Calendar API：
  1. 进入 "APIs & Services" > "Library"。
  2. 搜索并启用 "Gmail API"。
  3. 搜索并启用 "Google Calendar API"。
- 设置 OAuth 2.0 凭证：
  1. 进入 "APIs & Services" > "Credentials"。
  2. 点击 "Create Credentials" > "OAuth client ID"。
  3. 选择 "Web 应用程序"。
  4. 设置 "Authorized redirect URIs" 包括：http://localhost:4100/code。
  5. 记下 Client ID 和 Client Secret。

安装方式

使用 Smithery 自动安装

通过 Smithery 自动安装：

$ npm install -g @rishipradeep-think41/gsuite-mcp

手动安装

手动下载并安装最新版本的 MCP 服务器：

下载 latest.mcp。
解压文件到目标目录。
运行 start_server.sh 或 start_server.bat 启动服务器。

💻 使用示例

基础用法

邮件操作示例

{
"command": "list_emails",
"params": {
"label": "INBOX",
"maxResults": 10
}
}

日历操作示例

{
"command": "create_event",
"params": {
"summary": "会议",
"location": "会议室 A",
"start_time": "2024-01-24T10:00:00Z",
"end_time": "2024-01-24T11:00:00Z"
}
}

📚 详细文档

故障排除

身份验证问题

确保所有必需的 OAuth 作用域已授予。
验证客户端 ID 和密钥是否正确。
检查刷新令牌是否有效。

API 错误

在 Google Cloud Console 中检查 API 配额和限制。
确保 API 对您的项目已启用。
验证请求参数是否符合要求的格式。

📄 许可证

本项目采用 MIT 许可证授权。

0 条评论
分类：日程