金大哥 - gmail-mcp MCP 详情

article

README

🚀 增强版 Gmail MCP 服务器

增强版 Gmail MCP 服务器是一个强大且功能丰富的模型上下文协议（MCP）服务器，由 Python 编写，可与 Gmail 集成。它能让 AI 助手（如 Claude）通过自然语言与 Gmail 交互，提供全面的电子邮件管理功能。

🚀 快速开始

先决条件

Python 3.8+
启用 Gmail API 的 Google Cloud 项目
OAuth 2.0 凭证

安装

# 克隆仓库
git clone https://github.com/theposch/gmail-mcp.git
cd gmail-mcp

# 设置虚拟环境
python -m venv .venv
source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate

# 安装包
pip install -e .

Google Cloud 配置

创建一个新 Google Cloud 项目
启用 Gmail API
创建 OAuth 2.0 凭证并下载 JSON 文件

配置服务器

编辑配置文件 config.py：

# 配置 Gmail 帐户信息
GMAIL_ACCOUNT = 'your_email@gmail.com'
GMAIL_PASSWORD = 'your_password'

# 配置 OAuth 2.0 凭证路径
CREDENTIALS_FILE = 'path/to/credentials.json'

启动服务器

运行以下命令启动 MCP 服务器：

python server.py

✨ 主要特性

📧 完整的电子邮件管理

发送带有自定义主题、内容和收件人的电子邮件
阅读并检索电子邮件正文及其全部元数据
将电子邮件移到垃圾箱并确认
标记电子邮件为已读/未读
直接在浏览器中打开电子邮件

📝 草稿管理

创建草稿邮件以供稍后审阅
列出所有草稿邮件
编辑现有草稿

🏷️ 高级标签管理

列出所有可用的标签
创建自定义标签
为电子邮件添加/移除标签
重命名现有标签
删除未使用的标签
按标签搜索邮件

📁 文件夹组织

创建新文件夹（实现为 Gmail 标签）
在文件夹之间移动电子邮件
列出所有可用的文件夹

🔍 强大搜索与过滤功能

使用 Gmail 的高级查询语法搜索邮件
管理和删除电子邮件过滤器
按发件人、收件人、主题、内容等进行过滤
通过灵活参数自定义搜索结果

🗄️ 存档管理

存档电子邮件（从收件箱中移除但不删除）
批量存档符合搜索标准的多个电子邮件
列出所有已存档邮件
将已存档邮件恢复到收件箱

🤝 贡献

欢迎贡献！请随意提交 Pull Request。

叉仓库
创建功能分支 (git checkout -b feature/amazing-feature)
提交更改 (git commit -m '添加一些神奇的功能')
推送到分支 (git push origin feature/amazing-feature)
打开 Pull Request

📄 许可证

本项目根据 GPL-3.0 许可证发布 - 请查看 LICENSE 文件了解详细信息。

🙏 致谢

受到社区中各种 MCP 服务器实现的启发
使用 Google 的官方 API 客户端库构建

gmail-mcp