Googleworkspace MCP Server

🚀 谷歌工作區 MCP 服務器

谷歌工作區 MCP 服務器是一個用於與谷歌工作區 API 交互的 Model Context Protocol (MCP) 服務器。支持 Gmail、Drive、Calendar、Docs、Sheets 和 Slides 等多個 API，能幫助開發者便捷地實現各種功能。

✨ 主要特性

• Gmail API：可實現發送電子郵件、列出郵件、管理標籤等操作。
• Drive API：支持列出文件、創建文件夾以及上傳文件。
• Docs API：能夠創建和編輯 Google 文檔。
• Sheets API：可以讀取和寫入電子表格數據。
• Slides API：可創建演示文稿和幻燈片。
• Calendar API：支持列出和創建日曆事件。
• 身份驗證：提供 OAuth2 身份驗證流程輔助工具。

📦 安裝指南

先決條件

• Node.js 16+
• 啟用必要 APIs 的谷歌雲項目
• OAuth 2.0 客戶端憑證

安裝命令

npm install

💻 使用示例

基礎用法

啟動服務器

npm run dev

與 MCP Inspector 結合使用

要使用 MCP Inspector 測試服務器，可執行以下命令：

npm run inspect

這將打開瀏覽器中的 MCP Inspector，允許你測試所有工具和資源。

高級用法

配置

1. 複製 .env.example 文件到 .env：

   cp .env.example .env
   

2. 使用你的谷歌 API 憑證編輯 .env 文件：

   CLIENT_ID=your_client_id
   CLIENT_SECRET=your_client_secret
   REDIRECT_URI=http://localhost:3000/oauth2callback
   REFRESH_TOKEN=your_refresh_token
   

3. 如果你還沒有 refresh token，可以使用服務器提供的身份驗證工具獲取。

身份驗證

如果沒有 refresh token，可以使用這些工具：

1. 使用 generate_auth_url 工具獲取授權 URL。
2. 在瀏覽器中打開該 URL 並授權應用程序。
3. 從重定向 URL 中複製授權代碼。
4. 使用 exchange_code_for_tokens 工具和代碼換取 refresh token。
5. 將 refresh token 添加到 .env 文件。

📚 詳細文檔

可用工具

Gmail

• gmail_list_messages：列出符合條件的 Gmail 郵件。
• gmail_get_message：通過 ID 獲取特定 Gmail 郵件。
• gmail_send_message：發送新郵件。
• gmail_list_labels：列出所有 Gmail 標籤。
• gmail_modify_message：修改郵件標籤。
• gmail_trash_message：將郵件移至垃圾桶。
• gmail_untrash_message：從垃圾桶中刪除郵件。
• gmail_create_draft：創建草稿。

Drive

• drive_list_files：列出 Google Drive 中的文件。
• drive_get_file：獲取特定文件的元數據。
• drive_create_folder：在 Google Drive 中創建新文件夾。
• drive_upload_file：上傳文件到 Google Drive。

Docs

• docs_get_document：獲取 Google 文檔內容。
• docs_create_document：創建新的 Google 文檔。
• docs_append_text：向文檔末尾添加文本。

Sheets

• sheets_get_values：從 Google 表格讀取值。
• sheets_update_values：更新表格中的值。
• sheets_create_spreadsheet：創建新 Google 表格。

Slides

• slides_create_presentation：創建新的 Google 幻燈片演示文稿。
• slides_get_presentation：獲取演示文稿的信息。
• slides_create_slide：在演示文稿中添加新幻燈片。

Calendar

• calendar_list_events：列出日曆事件。
• calendar_create_event：創建新的日曆事件。

資源

scheme://authority/path?query#fragment

例如：

workspace://auth/guide