MCP Gsuite

🚀 mcp-gsuite MCP服務器

mcp-gsuite MCP服務器可實現與Google產品的交互，支持Gmail和日曆集成，為用戶提供便捷的Google服務操作體驗。

🚀 快速開始

此MCP服務器支持Gmail和日曆集成，能幫助用戶更高效地管理Google賬戶相關的郵件和日程安排。

✨ 主要特性

通用特性

• 支持多個Google賬戶，方便用戶同時管理不同的賬號。

Gmail功能

• 獲取Gmail用戶信息，讓您快速瞭解賬戶基本情況。
• 可使用靈活的搜索查詢郵件，如查找未讀郵件、來自特定發件人的郵件、特定日期範圍內的郵件以及帶附件的郵件等。
• 根據ID檢索完整的電子郵件內容，精準獲取所需郵件信息。
• 創建新的草稿郵件，支持設置收件人、主題、正文和抄送選項。
• 刪除草稿郵件，清理無用的草稿。
• 回覆現有郵件，可選擇立即發送或保存為草稿。
• 一次根據ID檢索多個郵件，提高郵件獲取效率。
• 將多個附件從郵件保存到本地系統，方便保存重要附件。

日曆功能

• 管理多個日曆，輕鬆規劃不同日程安排。
• 在指定時間範圍內獲取日曆事件，清晰掌握日程情況。
• 創建日曆事件，包括設置開始和結束時間、標題、地點和描述。
• 更新現有事件或創建新事件（如果重複），靈活調整日程。
• 獲取所有當前用戶的Google日曆，全面瞭解日曆信息。
• 根據ID檢索單個事件，精準定位特定日程。
• 刪除事件，及時清理不再需要的日程。

📦 安裝指南

文檔未提及安裝步驟，故跳過此章節。

💻 使用示例

基礎用法

此MCP服務器可通過命令行選項指定自定義路徑來配置身份驗證和賬戶信息。以下是相關配置選項：

• --gauth-file：指定包含OAuth2客戶端配置的.gauth.json文件路徑，默認為./.gauth.json。
• --accounts-file：指定包含Google賬戶信息的.accounts.json文件路徑，默認為./.accounts.json。
• --credentials-dir：指定在成功身份驗證後存儲OAuth憑證的目錄，默認為當前工作目錄，每個賬戶使用子目錄.oauth.{email}.json。

高級用法

構建與發佈

準備將包進行分發的步驟如下：

# 同步依賴項並更新鎖定文件
uv sync

# 構建包分佈
uv build

上述命令將在dist/目錄中創建源代碼和輪分佈。

# 發佈到PyPI
uv publish

注意：您需要通過環境變量或命令行標誌設置PyPI憑據：

• 令牌：--token 或 UV_PUBLISH_TOKEN
• 或用戶名/密碼：--username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

調試

由於MCP服務器通過標準輸入輸出運行，調試可能具有挑戰性。為了獲得最佳調試體驗，我們強烈推薦使用MCP Inspector。

# 啟動MCP Inspector
npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-gsuite run mcp-gsuite

啟動後，Inspector將顯示一個URL，您可以在瀏覽器中訪問以開始調試。

# 查看服務器日誌
tail -n 20 -f ~/Library/Logs/Claude/mcp-server-mcp-gsuite.log

📚 詳細文檔

此MCP服務器可通過命令行選項指定自定義路徑來配置身份驗證和賬戶信息，這些選項在開發和測試場景中非常有用，特別是在需要管理多個環境或不同的配置集時。

🔧 技術細節

文檔未提及技術實現細節，故跳過此章節。

📄 許可證

文檔未提及許可證信息，故跳過此章節。