使用说明
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