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 邮件。