Gmail & Google Calendar

🚀 mcp-gsuite MCP 服務器

與 Google 產品交互的 MCP 服務器，藉助它可以輕鬆實現與 Gmail 和日曆等 Google 服務的集成。

🚀 快速開始

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

✨ 主要特性

通用特性

• 支持多個 Google 賬戶。

Gmail 功能

• 獲取您的 Gmail 用戶信息。
• 使用靈活搜索查詢電子郵件（例如，未讀郵件、來自特定發件人的郵件、日期範圍、帶附件的郵件）。
• 通過 ID 檢索完整的電子郵件內容。
• 創建新草稿郵件，支持收件人、主題、正文和附件。
• 發送電子郵件。
• 刪除電子郵件。

日曆功能

• 獲取 Google 日曆的所有事件。
• 創建新的日曆事件。
• 更新現有日曆事件。
• 刪除日曆事件。

📦 安裝指南

MCP 服務器可以通過命令行參數指定自定義路徑來管理身份驗證和賬戶信息：

• --gauth-file：指定包含 OAuth2 客戶端配置的 .gauth.json 文件路徑，默認為當前目錄。
• --accounts-file：指定包含 Google 賬戶信息的 .accounts.json 文件路徑，默認為當前目錄。
• --credentials-dir：指定身份驗證憑據存儲的目錄，默認為當前目錄，每個賬戶單獨保存為 .oauth.{email}.json。

示例用法：

uv run mcp-gsuite --gauth-file /path/to/custom/.gauth.json --accounts-file /path/to/custom/.accounts.json --credentials-dir /path/to/custom/credentials

這些選項在開發和測試場景中非常有用，特別是在需要管理多個配置或環境時。

💻 使用示例

基礎用法

目前文檔未提供基礎使用的代碼示例，可參考配置選項中的命令行示例來啟動服務器。

高級用法

目前文檔未提供高級使用的代碼示例，可參考開發部分的構建、發佈和調試相關命令。

📚 詳細文檔

開發

構建與發佈

要準備發行版本：

1. 同步依賴項並更新鎖定文件：

uv sync

2. 構建發行版：

uv build

這將在 dist/ 目錄下創建源代碼和輪格式分佈。 3. 發佈到 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