# Gmail MCP 伺服器

一個功能強大的 Gmail 模型情境協定（MCP）伺服器，整合完整的 Gmail API，讓 Claude 和 Cursor 等 AI 助理能夠使用自然語言來搜尋、閱讀、發送、整理和管理電子郵件。

Canonical URL: https://a2a-mcp.org/entry/gmail-mcp-zh-TW

Language: zh-TW

Category: MCP Servers

Updated: 2026-04-01

## 總覽

**Gmail MCP 伺服器** 是一個由社群開發的模型上下文協定（MCP）伺服器，能將 Gmail 與 AI 編碼及生產力助手整合。它讓大型語言模型（如 Claude Desktop、Cursor 及其他相容於 MCP 的客戶端）能透過自然語言指令，直接與你的 Gmail 帳戶互動。

目前存在多種實作版本，其中 `theposch/gmail-mcp` 是功能最豐富的基於 Python 版本之一。其他受歡迎的分支版本則在驗證方式（OAuth、IMAP/SMTP、AutoAuth 或無頭模式）、工具數量以及額外功能（如風格分析或批次操作）上提供不同的變體。

## 主要功能

- **郵件操作**：搜尋收件匣/對話串、讀取訊息、列出近期郵件，並取得包含附件的完整內容。
- **傳送與草擬**：撰寫並傳送新郵件或回覆、建立草稿，並維護對話串。
- **組織工具**：管理標籤、套用篩選器、封存、刪除，或標示為已讀/未讀。
- **進階能力**：分析郵件寫作風格、執行批次動作、匯出至 CSV，以及處理多帳戶設定。
- **安全驗證**：支援 Google OAuth2（建議）、透過 IMAP/SMTP 的應用程式密碼，或自動驗證方法。
- **對 LLM 友善的回應**：結構化、節省權杖的輸出，並提供具上下文感知的摘要。
- **客戶端相容性**：可與 Claude Desktop、Cursor、VS Code 擴充功能、Gemini CLI 及任何符合 MCP 規範的工具協同運作。

## 使用情境

- **智慧收件匣管理**：「總結我來自工作的未讀郵件，並標記緊急事項。」
- **自動回覆**：「以專業的後續追蹤回覆客戶 X 的最新對話串。」
-, **郵件分類與生產力**：「找出上週所有關於專案 Y 的郵件，並草擬一份狀態更新。」
- **風格匹配**：分析你過去的郵件，並生成符合你語調的回覆。
-
- **工作流程自動化**：與其他 MCP 伺服器（行事曆、任務、CRM）結合，實現由 AI 協調的完整生產力流程。

## 安裝與設定（常用方法）

大多數實作版本遵循相似的步驟：

1. **Google API 設定**（適用於 OAuth 版本）：在 Google Cloud 控制台建立專案，啟用 Gmail API，並設定 OAuth 同意畫面與憑證（桌面應用程式類型）。
2. **複製與安裝**：
   ```bash
   git clone https://github.com/theposch/gmail-mcp.git
   cd gmail-mcp
   pip install -r requirements.txt
   ```
3. **設定憑證**：為你的 OAuth 權杖設定 `credentials.json` 或環境變數。
4. **執行伺服器** 並將其加入你的 MCP 客戶端（Claude Desktop 設定、Cursor 設定等）。

某些變體提供更簡易的單檔案設定、Docker 映像，或可避免完整 API 金鑰設定的 Chrome 擴充功能橋接。

**注意**：授予郵件存取權限需謹慎，請務必查閱特定版本庫的 README，以獲取最新的驗證與安全建議。

## 熱門實作方案

- **theposch/gmail-mcp**：功能豐富的 Python 版本。
- **PaulFidika/gmail-mcp-server**：輕量級單文件方案，專注於搜尋、樣式分析與草稿撰寫。
- **jeremyjordan/mcp-gmail**：使用官方 MCP Python SDK 的簡潔實作。
- **GongRzhe/Gmail-MCP-Server** (AutoAuth)：簡化的身份驗證方案（已歸檔但仍具影響力）。
- 基於 IMAP/SMTP 或無頭模式版本，適用於不同安全性偏好。

許多使用者將 Gmail MCP 與 Google 日曆 MCP 結合使用，實現統一的生產力控制。

## 相容性與安全性

- **用戶端**：Claude Desktop/Code、Cursor 及大多數 MCP 工具。
- **身份驗證**：OAuth2（最安全／推薦）、IMAP 搭配應用程式密碼，或自訂方法。
- **授權條款**：通常為 MIT 或類似授權（請查閱各別儲存庫）。

Gmail MCP 伺服器透過將電子郵件轉化為對話式介面，顯著提升 AI 生產力，但請務必採用最低權限範圍，並在授予存取權限前審查程式碼。

## Tags

- gmail
- mcp
- 電子郵件
- ai整合
- claude
- cursor
- 自動化
- google-api
- 生產力

## Sources

- [Project website](https://github.com/theposch/gmail-mcp)