Jasonsum Gmail MCP Server

🚀 Gmail 服務器用於模型上下文協議 (MCP)

本 MCP 服務器與 Gmail 深度集成，可實現電子郵件的發送、刪除、閱讀、撰寫以及響應等操作，為用戶提供便捷的郵件管理體驗。

⚠️ 重要提示

此服務器允許 MCP 客戶端讀取、刪除和發送電子郵件，但客戶端在執行這些操作前會提示用戶，保障用戶操作的自主性。

點擊查看相關鏈接

✨ 主要特性

該 MCP 服務器具備一系列實用工具，可高效處理各類郵件操作：

• send-email：向指定收件人地址發送電子郵件，需提供收件人電子郵箱地址、郵件主題和郵件內容，操作完成後返回狀態和消息 ID。
• trash-email：將指定電子郵件移到廢紙簍，只需輸入自動生成的電子郵件 ID，操作成功後返回成功消息。
• mark-email-as-read：標記指定電子郵件為已讀，輸入電子郵件 ID 即可完成操作並獲得成功消息。
• get-unread-emails：檢索未讀郵件，返回包含未讀郵件 ID 的列表。
• read-email：檢索指定電子郵件內容，輸入電子郵件 ID 後返回包含郵件元數據的字典，並將該郵件標記為已讀。
• open-email：在瀏覽器中打開指定電子郵件，輸入電子郵件 ID 後返回成功消息並在默認瀏覽器中打開郵件。

📦 安裝指南

Gmail API 設置

1. 創建新的 Google Cloud 項目
2. 啟用 Gmail API
3. 配置 OAuth 同意屏幕
   • 選擇 "外部"，且此應用程序不會發布。
   • 將個人電子郵件地址添加為 "測試用戶"。
4. 添加 OAuth 範圍 https://www.googleapis.com/auth/gmail/modify
5. 創建應用類型的 OAuth 客戶端 ID，選擇 "桌面應用程序"
6. 下載客戶端的 OAuth 密鑰文件（JSON 格式）
7. 重命名密鑰文件並保存到本地計算機的安全位置，記住此路徑，啟動服務器時將通過參數 --creds 引用該路徑。

認證

運行以下命令進行認證：

python -m gmail_mcp --creds path/to/your/credentials.json

此命令將打開默認瀏覽器窗口以完成 Google 的 OAuth 流程。完成後，會看到成功消息，且會在 path/to/your/credentials.json 位置創建一個 crets.json 文件。此時，您就可以使用 Gmail MCP 服務器了！