Gmail MCP Server 3

🚀 谷歌工作區 MCP 服務器

谷歌工作區 MCP 服務器是一個基於 Model Context Protocol (MCP) 的工具，它提供了與 Gmail 和日曆 API 交互的能力。藉助 MCP 接口，用戶可以對電子郵件和日曆事件進行編程管理，極大地提高了工作效率。

🚀 快速開始

要使用谷歌工作區 MCP 服務器，你需要完成一系列的準備和設置工作。具體步驟如下：

1. Node.js：確保安裝 Node.js 版本 14 或更高。
2. Google Cloud Console：
   • 創建項目並啟用 Gmail API 和 Calendar API。
   • 為項目創建 OAuth 客戶端 ID，獲取 client_id、client_secret 和 refresh_token。
3. 環境變量：在服務器環境中設置以下變量：

   CLIENT_ID=your_client_id
   CLIENT_SECRET=your_client_secret
   REFRESH_TOKEN=your_refresh_token
   

4. 克隆倉庫：

   git clone https://github.com/yourusername/google-workspace-mcp.git
   cd google-workspace-mcp
   

5. 安裝依賴項：

   npm install
   

6. 創建憑證文件：
   • 在項目根目錄下創建 credentials.json 文件，內容如下：

     {
       "client_id": "your_client_id",
       "client_secret": "your_client_secret",
       "refresh_token": "your_refresh_token"
     }
     

7. 運行服務器：

   node index.js
   

✨ 主要特性

郵件工具

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

日曆工具

• list_events：列出 upcoming 日曆事件，支持日期範圍過濾
• create_event：創建新的日曆事件，支持與會者
• update_event：更新現有日曆事件
• delete_event：刪除日曆事件

💻 使用示例

基礎用法

郵件操作

1. 列出郵件：

   {
     "action": "list_emails",
     "params": {
       "limit": 10,
       "folder": "inbox"
     }
   }
   

2. 發送郵件：

   {
     "action": "send_email",
     "params": {
       "to": "recipient@example.com",
       "subject": "Test Email",
       "body": "This is a test email."
     }
   }
   

日曆操作

1. 創建事件：

   {
     "action": "create_event",
     "params": {
       "summary": "會議提醒",
       "location": "會議室 101",
       "description": "每週同步",
       "start": "2024-01-24T10:00:00Z",
       "end": "2024-01-24T11:00:00Z",
       "attendees": ["colleague@example.com"]
     }
   }
   

2. 更新事件：

   {
     "action": "update_event",
     "params": {
       "event_id": "event_id_to_update",
       "summary": "更新的會議標題",
       "location": "線上會議"
     }
   }
   

📚 詳細文檔

故障排除

1. 身份驗證問題：

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

2. API 錯誤：

   • 查看 Google Cloud Console 中的 API 配額和限制
   • 確保項目啟用了相關 API
   • 確認請求參數與要求格式一致

📄 許可證

本項目在 MIT License 下開源。