Gmail IMAP MCP Server
2025.03.11
2
Python邮件管理AI 助手集成交流协作
Gmail IMAP MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，用于通过 IMAP 协议与 Gmail 账户进行集成。该服务器允许 AI 助手读取、搜索和管理 Gmail 邮件，支持多种邮件操作功能。
View on GitHub
Overview
基本能力
产品定位
Gmail IMAP MCP Server 是一个用于 Gmail 集成的 MCP 服务器，旨在通过 IMAP 协议提供邮件管理功能，支持 AI 助手与 Gmail 账户的交互。
核心功能
- OAuth2 认证
- 邮件读取与搜索
- 邮件发送（支持附件）
- 标签管理（创建、删除、列表）
- 邮件移动与状态管理（标记已读/未读）
- 附件下载
- 多账户支持
适用场景
- AI 助手集成
- 邮件自动化管理
- 邮件分类与整理
- 邮件内容摘要
工具列表
- authenticate-gmail: 认证 Gmail 账户
- search-emails: 搜索邮件
- get-unread-emails: 获取未读邮件
- send-email: 发送邮件
- create-label: 创建标签
- delete-label: 删除标签
- list-labels: 列出标签
- move-email: 移动邮件
- download-attachment: 下载附件
- mark-as-read: 标记已读
- mark-as-unread: 标记未读
- summarize-emails: 邮件摘要
常见问题解答
- 认证问题: 确保
client_secret.json正确放置，并已启用 Gmail API。 - 连接问题: 检查网络连接和账户安全设置。
- 邮件发送问题: 检查 SMTP 访问权限和附件大小限制。
- 标签管理问题: 确保标签名称符合 Gmail 命名规范。
使用教程
使用依赖
- Python 3.12 或更高版本
- 已启用 Gmail API 的 Google Cloud 项目
- OAuth 2.0 客户端 ID 凭证
安装教程
- 克隆仓库:
git clone https://github.com/yourusername/gmail-imap-mcp.git cd gmail-imap-mcp - 创建并激活虚拟环境:
python -m venv .venv # Windows .venv\Scripts\activate # Unix/MacOS source .venv/bin/activate - 安装包:
pip install -e .
调试方式
- 启动服务器:
gmail-imap-mcp - 使用工具进行测试，例如:
json { "name": "get-unread-emails", "arguments": { "account": "[email protected]" } }