Gmail Imap MCP

🚀 Gmail IMAP 管理控制檯協議（MCP）服務器

Gmail IMAP MCP 服務器是一款命令行工具，藉助 IMAP 協議實現對 Gmail 郵件的管理與操作。它具備豐富功能，能獲取未讀或特定郵件、發送新郵件、創建和管理標籤、移動郵件以及下載附件等，極大提升郵件處理效率。

🚀 快速開始

Gmail IMAP MCP Server 可幫助你通過 IMAP 協議管理和操作 Gmail 郵件。下面為你介紹其使用方法。

✨ 主要特性

• 獲取未讀郵件
• 獲取特定郵件
• 發送新郵件
• 創建和管理標籤
• 移動郵件到不同標籤
• 下載附件

📦 安裝指南

安裝依賴

pip install gmail-imap-mcp-server

配置步驟

1. 在項目根目錄創建 config 文件夾。
2. 將 client_secret.json 放入 config 文件夾。
3. 運行身份驗證命令：

   python -m gmail_imap_mcp_server authenticate
   

💻 使用示例

基礎用法

獲取未讀郵件

python -m gmail_imap_mcp_server list-unread-emails [--label LABEL] [--limit LIMIT]

獲取特定郵件

python -m gmail_imap_mcp_server get-email <email_id>

發送新郵件

python -m gmail_imap_mcp_server send-email --to TO_EMAIL --subject SUBJECT --body BODY

創建標籤

python -m gmail_imap_mcp_server create-label LABEL_NAME

刪除標籤

python -m gmail_imap_mcp_server delete-label LABEL_NAME

修改標籤

python -m gmail_imap_mcp_server rename-label OLD_NAME NEW_NAME

移動郵件

python -m gmail_imap_mcp_server move-email <email_id> TARGET_LABEL

下載附件

python -m gmail_imap_mcp_server download-attachment <attachment_id> --output OUTPUT_PATH

高級用法

樣例1：獲取未讀郵件

$ python -m gmail_imap_mcp_server list-unread-emails --label Inbox

輸出：

Email ID: 12345, From: boss@example.com, Subject: Q4 Report Due
Email ID: 67890, From: client@example.com, Subject: Project Update

樣例2：發送郵件

$ python -m gmail_imap_mcp_server send-email --to team@example.com --subject "Meeting Tomorrow" --body "Please join the meeting at 2 PM."

樣例3：獲取郵件內容

$ python -m gmail_imap_mcp_server get-email m1@abc.xyz

輸出：

From: boss@example.com
To: me@example.com
Subject: Q4 Report
Body: Please review the attached report.

樣例4：簡單郵件發送

from gmail_imap_mcp_server import GmailIMAPMCPClient

client = GmailIMAPMCPClient()
client.send_email(
    to="team@example.com",
    subject="Meeting Tomorrow",
    body="Please join the meeting at 2 PM."
)

樣例5：帶附件的郵件發送

import os
from gmail_imap_mcp_server import GmailIMAPMCPClient

client = GmailIMAPMCPClient()
client.send_email(
    to="receiver@example.com",
    subject="Document Attached",
    body="Please find attached the document.",
    attachments=[os.path.abspath("document.pdf")]
)

📚 詳細文檔

故障排除

問題1：無法連接到 Gmail

$ python -m gmail_imap_mcp_server authenticate

按照提示輸入 Gmail 賬戶信息。

問題2：找不到郵件

• 檢查郵件 ID 是否正確。
• 確保目標標籤存在。

安全考慮

⚠️ 重要提示

• 避免使用 --noauth_local_webserver 標誌進行身份驗證。
• 不要在生產環境中明文存儲憑據。
• 定期更新 Gmail 密碼。

📄 許可證

本項目遵循 MIT 協議。
See LICENSE for more details.

貢獻者

• 張三 (zhangsan@example.com)
• 李四 (lisi@example.com)

Gmail IMAP MCP Server 為您提供強大、靈活的郵件管理能力，助您高效處理 Gmail 郵件。