Gmail IMAP 管理控制台协议（MCP）服务器

介绍

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

Gmail 特定功能

获取邮件内容

$ 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.

代码示例

简单邮件发送

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."
)

带附件的邮件发送

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 是否正确。
• 确保目标标签存在。

安全考虑

1. 避免使用 --noauth_local_webserver 标志进行身份验证。
2. 不要在生产环境中明文存储凭据。
3. 定期更新 Gmail 密码。

许可证

本项目遵循 MIT 协议。
See LICENSE for more details.

贡献者

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

Gmail IMAP MCP Server 为您提供强大、灵活的邮件管理能力，助您高效处理 Gmail 邮件。