Gsuite MCP

🚀 Google 工作區 MCP 服務器

一個提供 Gmail 和日曆 API 工具的 Model Context Protocol (MCP) 服務器，允許通過 MCP 接口對電子郵件和日曆事件進行編程管理，為用戶提供便捷的郵件與日曆操作體驗。

🚀 快速開始

若要使用此 MCP 服務器，需完成先決條件的設置，然後選擇合適的安裝方式進行安裝。安裝完成後，即可參考使用說明進行郵件和日曆操作。

✨ 主要特性

郵件工具

• list_emails：列出收件箱中的近期郵件，還可進行可選過濾。
• search_emails：支持使用 Gmail 查詢語法進行高級郵件搜索。
• send_email：能夠發送新郵件，並且支持 CC 和 BCC。
• modify_email：可修改郵件標籤，如存檔、刪除、標記為已讀/未讀。

日曆工具

• list_events：列出即將進行的日曆事件，可選擇日期範圍進行過濾。
• create_event：創建新的日曆事件，支持添加參與者。
• update_event：更新現有日曆事件。
• delete_event：刪除日曆事件。

📦 安裝指南

先決條件

1. Node.js：安裝 Node.js 14 或更高版本。
2. 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 服務器：

1. 下載 latest.mcp。
2. 解壓文件到目標目錄。
3. 運行 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"
  }
}

📚 詳細文檔

故障排除

1. 身份驗證問題：

   • 確保所有必需的 OAuth 作用域已授予。
   • 驗證客戶端 ID 和密鑰是否正確。
   • 檢查刷新令牌是否有效。

2. API 錯誤：

   • 在 Google Cloud Console 中檢查 API 配額和限制。
   • 確保 API 對您的項目已啟用。
   • 驗證請求參數是否符合要求的格式。

📄 許可證

本項目採用 MIT 許可證。