什麼是MCP Gmail?

MCP Gmail 是一個基於Google Apps Script構建的MCP服務器，允許您通過Claude Desktop等客戶端與您的Gmail賬戶進行交互。您可以輕鬆地搜索郵件、獲取郵件詳情以及下載附件。

如何使用MCP Gmail?

首先部署Google Apps Script，然後在Claude Desktop中配置服務器地址和API密鑰。完成設置後，即可開始使用相關功能。

適用場景

適用於需要快速訪問Gmail郵件內容的專業人士，例如處理工作郵件、管理日程安排等。

主要功能

搜索郵件支持使用Gmail搜索語法查找郵件，例如按主題、時間範圍篩選。

獲取郵件詳情獲取指定郵件的詳細信息，包括髮件人、收件人、正文等內容。

下載附件從指定郵件中下載附件文件。

優勢與侷限性

優勢

無需安裝額外軟件即可操作Gmail

支持多種搜索條件，提高工作效率

安全可靠，僅授權用戶可訪問

侷限性

依賴Google Apps Script環境運行

部分高級功能可能受權限限制

如何使用

部署Google Apps Script

訪問Google Apps Script平臺，創建新項目並將提供的代碼複製粘貼到編輯器中。點擊部署按鈕，選擇執行者為‘我’，訪問權限設置為‘任何人’。

生成API密鑰

在Google Apps Script部署完成後，生成隨機的API密鑰用於身份驗證。

配置Claude Desktop

打開Claude Desktop配置文件，添加MCP Gmail工具的相關信息。

使用案例

搜索最近一天的主題為“會議”的郵件用戶希望查找昨天收到的所有關於“會議”的郵件。

獲取特定郵件的完整內容用戶需要查看某封郵件的具體內容，包括髮件人、收件人和正文。

常見問題

如何確保我的API密鑰安全？

為什麼無法找到某些郵件？

是否支持多賬戶登錄？

🚀 MCP Gmail 服務器端

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

🚀 快速開始

快速上手（用戶）

先決條件

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

配置

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

腳本需要 Gmail 訪問權限。首次部署和運行腳本時，Google 會要求您審查並授予這些權限。請按以下步驟操作：
1. 點擊 “審查權限”。
2. 選擇您的 Google 帳戶。
3. 如果出現警告，點擊 “高級”。
4. 點擊 “前往 [您的項目名稱] (不安全)”。
5. 點擊 “允許” 授予必要的 Gmail 權限。
打開 Claude 桌面版配置文件 配置文件路徑為：~/Library/Application Support/Claude/claude_desktop_config.json。

您可以通過以下步驟找到此文件：
1. 打開 Claude 桌面版。
2. 點擊菜單欄中的 “Claude”。
3. 選擇 “設置”。
4. 點擊 “開發者”。
在配置文件中添加以下內容

{
  "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

開發配置

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

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

修改您的 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"
      }
    }
  }
}