Gmail IMAP MCP 服务器

Gmail IMAP MCP 服务器

用于集成 Gmail 和 AI 助手的 IMAP MCP 服务器,支持邮件读取、搜索和管理。

快速入门

  1. 克隆仓库: git clone https://github.com/tonykipkemboi/gmail-imap-mcp.git cd gmail-imap-mcp

  2. 创建虚拟环境并安装依赖: python -m venv .venv

    Windows

    .venv\Scripts\activate

    Unix/MacOS

    source .venv/bin/activate pip install -e .

  3. 配置 Google Cloud 项目:

    • 启用 Gmail API
    • 创建 OAuth 2.0 凭据并下载 client_secret.json 文件
    • 将文件保存到 ~/.gmail_imap_mcp_credentials/client_secret.json
  4. 启动服务器: gmail-imap-mcp

  5. 认证 Gmail 账户: 使用 authenticate-gmail 工具完成 OAuth2 流程。

  6. 示例命令:

    • 搜索邮件:search-emails
    • 发送邮件:send-email
    • 管理标签:create-label, delete-label, list-labels
    • 移动邮件:move-email
    • 下载附件:download-attachment

更多工具和示例请参考 README。