Gmail MCP

🚀 Gmail MCP 配置指南

本指南旨在幫助你配置 Gmail MCP，使 Claude 能夠從你的 Gmail 賬戶中搜索並檢索郵件，為信息獲取提供便利。

🚀 快速開始

✨ 主要特性

• 允許 Claude 從 Gmail 賬戶搜索和檢索郵件。
• 提供搜索郵件、獲取郵件內容、列出收件箱最近郵件等工具。

📦 安裝指南

獲取 Google API 憑證

1. 訪問 Google Cloud Console。
2. 創建新項目或選擇現有項目。
3. 啟用項目的 Gmail API：
   • 進入 "APIs & Services" > "Library"。
   • 搜索 "Gmail API" 並啟用它。
4. 創建 OAuth 憑證：
   • 前往 "APIs & Services" > "Credentials"。
   • 點擊 "創建憑證" > "OAuth 客戶端 ID"。
   • 選擇應用類型為 "桌面應用"。
   • 輸入名稱並點擊 "創建"。
5. 下載憑證 JSON 文件。
6. 將其保存為 credentials.json 放置在你的項目目錄中。

授權應用程序

運行授權命令以生成令牌：

uv run gmail-mcp auth --creds-path credentials.json --token-path token.json

這將打開瀏覽器窗口，你需要登錄 Google 賬戶並授予必要的權限。授權完成後，會在項目目錄中創建 token.json 文件。

💻 使用示例

基礎用法

在 Claude 中配置 Gmail MCP 服務器，將以下內容添加到你的 Claude 配置文件：

{
  "mcpServers": {
    "gmail": {
      "args": [
        "--from",
        "git+https://github.com/vinayak-mehta/gmail-mcp",
        "gmail-mcp"
      ],
      "command": "/Users/username/.local/bin/uvx",
      "env": {
        "GMAIL_CREDS_PATH": "/Users/username/path/to/gmail-mcp/credentials.json",
        "GMAIL_TOKEN_PATH": "/Users/username/path/to/gmail-mcp/token.json"
      }
    }
  }
}

請確保：

• 將 /Users/username/path/to/gmail-mcp 替換為你的實際項目路徑。
• 調整 command 路徑以匹配你安裝的 uvx 可執行文件。
• 提供正確的憑證和令牌文件路徑。

高級用法

Claude 現在擁有以下工具：

• 搜索郵件：在你的 Gmail 賬戶中搜索郵件。 示例提示："查找所有來自 example@gmail.com 的郵件"
• 獲取郵件內容：檢索特定郵件的完整內容。 示例提示："顯示主題為 '明天開會' 的郵件全文"
• 列出消息：列出你 Gmail 收件箱中的最近郵件。 示例提示："列出我最 recent 的 5 封郵件"

📚 詳細文檔

環境變量配置

你可以通過環境變量來配置憑證和令牌文件的路徑：

• GMAIL_CREDS_PATH：憑證 JSON 文件的路徑。
• GMAIL_TOKEN_PATH：令牌 JSON 文件的路徑。

在項目根目錄中創建一個 .env 文件，添加這些變量以實現便捷配置。