Gmail IMAP MCP 服务器
用于集成 Gmail 和 AI 助手的 IMAP MCP 服务器,支持邮件读取、搜索和管理。
快速入门
-
克隆仓库: git clone https://github.com/tonykipkemboi/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 .
-
配置 Google Cloud 项目:
- 启用 Gmail API
- 创建 OAuth 2.0 凭据并下载 client_secret.json 文件
- 将文件保存到 ~/.gmail_imap_mcp_credentials/client_secret.json
-
启动服务器: gmail-imap-mcp
-
认证 Gmail 账户: 使用 authenticate-gmail 工具完成 OAuth2 流程。
-
示例命令:
- 搜索邮件:search-emails
- 发送邮件:send-email
- 管理标签:create-label, delete-label, list-labels
- 移动邮件:move-email
- 下载附件:download-attachment
更多工具和示例请参考 README。