@kazuph/mcp Gmail Gas

🚀 MCP Gmail 服務器端

此模型上下文協議 (MCP) 服務器用於 Gmail 集成，允許 Claude 桌面版（或其他 MCP 客戶端）通過 Google Apps 腳本與您的 Gmail 帳戶交互，實現自動化郵件處理任務。

🚀 快速開始

快速上手（用戶）

先決條件

• Node.js 18+（可通過 brew install node 進行安裝）
• 擁有一個 Gmail 帳戶
• 完成 Google Apps 腳本部署
• 安裝 Claude 桌面版（可從 Claude 桌面版官網 下載安裝）

配置

1. 部署 Google Apps 腳本

   • 訪問 Google Apps Script 創建一個新項目。
   • 複製 code.gs 文件中的所有內容，並粘貼到腳本編輯器中。
   • 點擊 “部署” > “新建部署”。
   • 選擇 “網絡應用” 作為部署類型。
   • 進行以下配置設置：
     • 執行身份：我
     • 訪問權限：任何人
   • 點擊 “部署”。
   • 當出現提示時，審查並授權腳本訪問您的 Gmail 帳戶。
   • 複製部署 URL，並生成一個隨機的 API 密鑰以確保安全。

   ⚠️ 重要提示

   腳本需要 Gmail 訪問權限。首次部署和運行腳本時，Google 會要求您審查並授予這些權限。請按以下步驟操作：

   1. 點擊 “審查權限”。
   2. 選擇您的 Google 帳戶。
   3. 如果出現警告，點擊 “高級”。
   4. 點擊 “前往 [您的項目名稱] (不安全)”。
   5. 點擊 “允許” 授予必要的 Gmail 權限。

2. 打開 Claude 桌面版配置文件 配置文件路徑為：~/Library/Application Support/Claude/claude_desktop_config.json。

   您可以通過以下步驟找到此文件：

   1. 打開 Claude 桌面版。
   2. 點擊菜單欄中的 “Claude”。
   3. 選擇 “設置”。
   4. 點擊 “開發者”。

3. 在配置文件中添加以下內容

{
  "tools": {
    "gmail": {
      "command": "npx",
      "args": ["-y", "@kazuph/mcp-gmail-gas"],
      "env": {
        "GAS_ENDPOINT": "YOUR_DEPLOYMENT_URL",
        "VALID_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

⚠️ 重要提示

請將 YOUR_DEPLOYMENT_URL 和 YOUR_API_KEY 替換為您實際的值。

開發者指南

先決條件

• Node.js 18+（可通過 brew install node 進行安裝）
• 擁有一個 Gmail 帳戶
• 具備 Google Apps 腳本相關知識
• 安裝 Claude 桌面版（可從 Claude 桌面版官網 下載安裝）
• 安裝 tsx（可通過 npm install -g tsx 進行安裝）

安裝

git clone https://github.com/kazuph/mcp-gmail-gas.git
cd mcp-gmail-gas
npm install
npm run build

開發配置

1. 確保 Claude 桌面版已安裝並處於運行狀態。
2. 如果尚未安裝，可全局安裝 tsx：

npm install -g tsx
# 或者
pnpm add -g tsx

3. 修改您的 Claude 桌面版配置文件，文件路徑為：~/Library/Application Support/Claude/claude_desktop_config.json。 在 MCP 客戶端的配置中添加以下內容：

{
  "tools": {
    "gmail": {
      "command": "npx",
      "args": ["-y", "@kazuph/mcp-gmail-gas"],
      "env": {
        "GAS_ENDPOINT": "YOUR_DEPLOYMENT_URL",
        "VALID_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

⚠️ 重要提示

請將 YOUR_DEPLOYMENT_URL 和 YOUR_API_KEY 替換為您實際的值。

可用工具

項目提供了以下實用功能：

1. 搜索郵件
2. 獲取特定郵件內容
3. 下載附件

注意事項

⚠️ 重要提示

• 安全第一：請確保 API 密鑰的保密性，避免因洩露導致安全風險。
• 權限管理：合理設置 Google Apps 腳本的權限，防止未經授權的訪問。

通過此項目，您可以方便地將 Claude 桌面版與 Gmail 集成，實現自動化郵件處理任務。