MCP Gmail

🚀 MCP Gmail 服務器

MCP Gmail 服務器是一個基於 Model Context Protocol (MCP) 的服務器，它藉助 MCP Python SDK 實現了對 Gmail 的便捷訪問。通過該服務器，用戶能夠以 MCP 資源的形式操作 Gmail 郵件，還能使用一系列工具來創建、發送、搜索郵件等。

✨ 主要特性

• 資源暴露：將 Gmail 消息作為 MCP 資源暴露，方便用戶統一管理和操作。
• 郵件工具豐富：提供了 compose_email、send_email、search_emails 等多種工具，涵蓋了郵件的創建、發送、搜索等常見操作。
• 標籤管理：支持對郵件標籤的操作，如 list_available_labels、add_label_to_message、remove_label_from_message 等。

📦 安裝指南

第一步：安裝依賴項

使用 uv 命令同步項目並安裝所有必要的依賴項：

uv sync

第二步：配置 OAuth 憑證

1. 打開 Google Cloud Console 並創建一個新的項目。
2. 啟用 Gmail API。
3. 進入 OAuth 界面設置部分，填寫應用信息和權限範圍。
4. 創建 OAuth 客戶端 ID 並下載 credentials.json 文件。

第三步：驗證配置

運行以下命令以確保配置正確：

python test_script.py

🚀 快速開始

啟動服務器

• 開發模式：在開發模式下啟動服務器，使用以下命令：

uv run server.py

• 安裝到 Claude Desktop：配置 command 屬性為正確的 uv 可執行文件路徑，並設置環境變量指向 credentials.json 和 token.json 文件。

環境變量配置

項目可以通過以下環境變量進行配置：

💻 使用示例

可用資源

• gmail://messages/{message_id}: 訪問單個郵件消息
• gmail://threads/{thread_id}: 訪問郵件主題

可用工具

• compose_email: 創建新郵件草稿
• send_email: 發送郵件
• search_emails: 根據發件人、收件人或主題搜索郵件
• query_emails: 使用原始 Gmail 查詢語法搜索郵件
• get_emails: 按 ID 獲取多個郵件消息
• list_available_labels: 獲取所有可用的 Gmail 標籤
• mark_message_read: 標記消息為已讀
• add_label_to_message: 向消息添加標籤
• remove_label_from_message: 從消息移除標籤

📄 許可證

本項目採用 MIT 許可證。