Epaproditus Google Workspace MCP Server

一個基於MCP協議的Google Workspace服務端工具，提供Gmail和日曆API的編程接口，用於管理郵件和日曆事件。

開發者工具日程管理 #郵件管理 #日曆管理 #API集成 #Google服務本地 .JavaScript

評分 : 2分

下載量 : 5.2K

更新時間 : 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"]
}