G Suite Integration

🚀 mcp-gsuite MCP服務器

與Google產品交互的MCP服務器，藉助它可實現與Gmail、日曆等Google服務的便捷集成。

🚀 快速開始

此MCP服務器支持Gmail和日曆集成，能與Google產品進行交互。

✨ 主要特性

通用特性

• 支持多個Google賬戶。

Gmail相關特性

• 獲取您的Gmail用戶信息。
• 使用靈活搜索查詢郵件（例如，未讀、來自特定發件人、日期範圍、帶有附件）。
• 按ID檢索完整的電子郵件內容。
• 創建新的草稿郵件，帶有收件人、主題、正文和抄送選項。
• 刪除草稿郵件。
• 回覆現有郵件（可以立即發送或保存為草稿）。
• 一次按其ID檢索多個郵件。
• 將多個附件從郵件保存到本地系統。

日曆相關特性

• 管理多個日曆。
• 在指定時間範圍內獲取日曆事件。
• 創建帶有以下內容的日曆事件：
  • 標題，開始/結束時間。
  • 可選位置和描述。
  • 可選與會者。
  • 自定義時區支持。
  • 通知偏好設置。
• 刪除日曆事件。

示例提示

您可以嘗試以下示例提示來體驗服務器功能：

• 獲取我最新的未讀消息。
• 搜索來自Scrum Master的郵件。
• 獲取會計的所有郵件。
• 查看關於ABC的郵件並進行摘要。
• 寫一封感謝Alice最後一封郵件的回覆並保存為草稿。
• 回覆Bob的郵件，內容為“非常感謝”。將其作為草稿存儲。
• 我明天的日程安排是什麼？
• 這周我有哪些會議？
• 在我的日曆中找到所有與客戶A相關的事件。

📚 詳細文檔

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服務器通過stdio運行，調試可能具有挑戰性。為了獲得最佳調試體驗，我們強烈推薦使用MCP Inspector。

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

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

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