IMAP邮件管理工具

该工具通过MCP服务器提供Gmail IMAP功能,包括获取未读邮件和下载邮件附件。

  • by SCGCWebmaster
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 SCGCWebmaster/imap_mcp

使用说明

imap_mcp

克劳德代码的IMAP电子邮件MCP服务器。将Gmail IMAP功能作为两个MCP工具公开。

工具

  • get_unread_email_by_sender_email -从指定发件人获取未读电子邮件。返回电子邮件元数据(ID、主题、发件人、日期、附件文件名)。
  • download_email_attachment -使用电子邮件ID将电子邮件内容和附件下载到本地文件夹。

设置

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

复制 .env.example 到 .env 并填写您的凭据:

cp .env.example .env

添加到克劳德代码

claude mcp add --transport stdio --scope project imap-email \
  -e EMAIL_ACCOUNT=your_email@gmail.com \
  -e APP_PASS="your_app_password" \
  -- ~/code/imap_mcp/venv/bin/python ~/code//imap_mcp/server.py

选项:

  • --scope user 使其可用于所有项目。使用 --scope project 仅适用于当前项目。
  • -e 将环境变量传递给服务器进程。

添加后,重新启动Claude Code并用验证 /mcp.

环境变量

变量 必填 描述
EMAIL_ACCOUNT 是 Gmail地址
APP_PASS 是 Gmail应用程序密码
IMAP_SERVER 无 IMAP服务器(默认值: imap.gmail.com)
IMAP_PORT 无 IMAP端口(默认值: 993)

claude mcp add--传输标准io--范围项目imap电子邮件
-e电子邮件_ACCOUNT=webmaster@gliding.com.au
-e APP_PASS=“aaxz txvd rmhm dnkg”
--~/code/imap_mcp/venv/bin/python服务器.py