AI导哈

Gmail IMAP MCP 服务

Gmail IMAP MCP 服务是一个基于 IMAP 协议的 Gmail 集成服务，允许 AI 助手与 Gmail 账户进行交互，提供读取、搜索和管理邮件的功能。该服务支持 OAuth2 认证、高级邮件搜索、标签管理、附件下载等功能，适用于需要自动化邮件处理的场景。

  • by fourdots
  • 更新于
在 GitHub 查看 fourdots/gmail-mcp

使用说明

基本能力

产品定位

Gmail IMAP MCP 服务是一个专为 AI 助手设计的 Gmail 集成工具，通过 IMAP 协议提供邮件管理和自动化处理能力。

核心功能

  • OAuth2 认证：支持 Gmail 账户的安全认证。
  • 邮件读取与搜索：支持高级搜索功能，包括日期范围、标签、关键词等过滤条件。
  • 邮件发送：支持发送邮件和附件，以及回复邮件和线程。
  • 标签管理：支持创建、删除和移动标签。
  • 附件下载：支持从邮件中下载附件。
  • 邮件状态管理：支持标记邮件为已读或未读。
  • 多账户支持：支持多个 Gmail 账户的集成。

适用场景

  • 邮件自动化处理：适用于需要自动化处理邮件的场景，如客户支持、任务管理等。
  • 邮件分类与整理：适用于需要批量整理邮件的场景，如项目邮件分类。
  • 邮件搜索与过滤：适用于需要快速查找特定邮件的场景，如法律或财务审计。

使用教程

使用依赖

  1. 安装 Python 3.12 或更高版本。
  2. 创建 Google Cloud 项目并启用 Gmail API。
  3. 配置 OAuth 2.0 客户端 ID 凭证。

安装教程

  1. 克隆仓库：
    git clone https://github.com/yourusername/gmail-imap-mcp.git
cd gmail-imap-mcp
  2. 创建并激活虚拟环境：
    python -m venv .venv
# Windows
.venv\Scripts\activate
# Unix/MacOS
source .venv/bin/activate
  3. 安装依赖：
    pip install -e .

调试方式

  1. 启动服务：
    gmail-imap-mcp
  2. 使用 authenticate-gmail 工具认证 Gmail 账户：
    {
  "name": "authenticate-gmail",
  "arguments": {
    "email": "your.email@gmail.com"
  }
}
  3. 使用其他工具进行邮件操作，如 search-emails、send-email 等。

相关 MCP