Epaproditus Google Workspace MCP Server

一个基于MCP协议的Google Workspace服务端工具，提供Gmail和日历API的编程接口，用于管理邮件和日历事件。

开发者工具日程管理 #邮件管理 #日历管理 #API集成 #Google服务本地 .JavaScript

评分 : 2分

下载量 : 11

更新时间 : 2025-04-29

什么是Google Workspace MCP Server?

这是一个连接Google Workspace服务的中间件服务器，通过标准化的Model Context Protocol(MCP)接口，让开发者或终端用户可以通过简单的JSON指令来管理Gmail邮箱和Google日历。

如何使用本服务?

您需要先完成Google Cloud项目的API授权配置，然后通过发送符合MCP协议的JSON指令来操作系统。支持的操作包括收发邮件、管理日历事件等。

适用场景

适用于需要自动化处理邮件/日历的个人用户、企业工作流自动化、客服系统集成等场景。

主要功能

邮件列表查询支持按条件筛选和分页查询收件箱邮件

高级邮件搜索使用Gmail原生查询语法进行复杂邮件检索

发送邮件支持带附件、抄送/密送的邮件发送功能

日历事件管理完整的日历事件创建/读取/更新/删除(CRUD)功能

优势与局限性

优势

标准化MCP接口，易于集成到现有系统

完整的Gmail和Calendar API功能覆盖

详细的错误处理和日志记录

局限性

需要Google Cloud项目配置，初始设置较复杂

受Google API配额限制

目前仅支持Node.js环境运行

如何使用

获取Google API凭证

在Google Cloud Console中创建项目并启用Gmail和Calendar API

配置OAuth授权

设置重定向URI并获取客户端ID/密钥

获取刷新令牌

运行授权脚本获取长期有效的刷新令牌

启动MCP服务器

配置环境变量后启动服务

使用案例

查询未读邮件获取最近5封未读邮件的基本信息

创建团队会议在日历上创建一个1小时的团队会议

常见问题

为什么需要刷新令牌?

如何增加API调用配额?

支持哪些邮件搜索语法?

🚀 Google 工作区 MCP 服务器

这是一个基于 Model Context Protocol (MCP) 的服务器，它提供了与 Gmail 和日历 API 交互的工具。借助 MCP 接口，你能够对电子邮件和日历事件进行编程管理，极大提升工作效率。

🚀 快速开始

本服务器可让你轻松通过 MCP 接口对 Gmail 邮件和日历事件进行编程管理。在使用前，请确保完成以下先决条件和设置步骤。

✨ 主要特性

Gmail 工具

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 Workspace API 和 Calendar API。
- 配置 OAuth 2.0 凭证，授予以下作用域： https://www.googleapis.com/auth/gmail.readonly、https://www.googleapis.com/auth/calendar

设置步骤

克隆代码仓库：

git clone https://github.com/your-repository.git
cd your-repository

安装依赖项：
```
npm install
```

创建凭证文件：

在 Google Cloud Console 中创建 credentials.json 文件，内容示例如下：

{
    "type": "service_account",
    "project_id": "your-project-id",
    "private_key_id": "your-private-key-id",
    "client_email": "your-service-account@your-project-id.iam.gserviceaccount.com",
    "private_key": "your-private-key",
    "client_id": "your-client-id",
    "auth_uri": "https://accounts.google.com/o/oauth2/auth",
    "token_uri": "https://oauth2.googleapis.com/token",
    "AuthProviderLink": "https://www.googleapis.com/auth/",
    "Authority": "https://accounts.google.com/o/oauth2/auth"
}

获取刷新令牌：
```
npm run get-refresh-token
```

配置 MCP 设置

根据以下路径配置不同 IDE 的 MCP 设置：
- VS Code：~/.config/google/workspace-mcp/setting.json
- IntelliJ IDEA：File > Settings > Google Workspace MCP Config
- PyCharm：File > Settings > Google Workspace MCP Config

示例配置内容如下：

{
    "gmail": {
        "apiKey": "your-gmail-api-key",
        "refreshToken": "your-refresh-token"
    },
    "calendar": {
        "apiKey": "your-calendar-api-key",
        "refreshToken": "your-refresh-token"
    }
}

构建与运行

npm run build
npm start

💻 使用示例

基础用法

Gmail 示例

列出邮件：

{
    "command": "list_emails",
    "maxResults": 10,
    "q": "subject:meeting"
}

发送邮件：

{
    "command": "send_email",
    "to": "recipient@example.com",
    "subject": "测试邮件",
    "body": "这是测试邮件内容。"
}

日历示例

创建事件：

{
    "command": "create_event",
    "summary": "团队会议",
    "location": "会议室",
    "description": "每周同步",
    "start": "2024-01-24T10:00:00Z",
    "end": "2024-01-24T11:00:00Z",
    "attendees": ["colleague@example.com"]
}