🚀 Gmail IMAP 管理控制台协议（MCP）服务器
Gmail IMAP MCP 服务器是一款命令行工具，借助 IMAP 协议实现对 Gmail 邮件的管理与操作。它具备丰富功能，能获取未读或特定邮件、发送新邮件、创建和管理标签、移动邮件以及下载附件等，极大提升邮件处理效率。
🚀 快速开始
Gmail IMAP MCP Server 可帮助你通过 IMAP 协议管理和操作 Gmail 邮件。下面为你介绍其使用方法。
✨ 主要特性
- 获取未读邮件
- 获取特定邮件
- 发送新邮件
- 创建和管理标签
- 移动邮件到不同标签
- 下载附件
📦 安装指南
安装依赖
pip install gmail-imap-mcp-server
配置步骤
- 在项目根目录创建
config文件夹。 - 将
client_secret.json放入config文件夹。 - 运行身份验证命令：
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
发送新邮件
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 TARGET_LABEL
下载附件
python -m gmail_imap_mcp_server download-attachment --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 邮件。