← Back to Skills Marketplace
6047
Downloads
1
Stars
26
Active Installs
4
Versions
Install in OpenClaw
/install imap-email
Description
Read and manage email via IMAP (ProtonMail Bridge, Gmail, etc.). Check for new/unread messages, fetch content, search mailboxes, and mark as read/unread. Works with any IMAP server including ProtonMail Bridge.
Usage Guidance
Install only if you are comfortable giving the agent access to your mailbox. Use a Bridge-generated or app-specific password, manually ensure .env is excluded from version control and permissions are restricted, keep certificate checks enabled except for trusted local Bridge use, and replace or avoid the cron iMessage example unless you explicitly want email summaries sent to that destination.
Capability Analysis
Type: OpenClaw Skill
Name: imap-email
Version: 1.0.3
The skill is classified as suspicious due to the presence of a configurable option, `IMAP_REJECT_UNAUTHORIZED=false`, which, while documented for specific use cases like ProtonMail Bridge, introduces a significant man-in-the-middle (MITM) vulnerability if enabled without proper understanding or in untrusted environments. Additionally, the `setup.sh` script directly writes user-provided credentials into the `.env` file. While the Node.js script loads these as environment variables, this pattern of direct user input handling in a shell script can be a vulnerability if not carefully implemented or if the input is maliciously crafted, even if not immediately exploitable for shell injection in this specific context. There is no evidence of intentional malicious behavior such as data exfiltration to unauthorized endpoints, backdoors, or stealthy operations.
Capability Assessment
Purpose & Capability
Reading, searching, fetching, and marking IMAP mail read or unread matches the stated purpose, but it grants the agent access to sensitive email contents and mailbox state changes.
Instruction Scope
The cron example sends recurring email summaries to iMessage using a hard-coded phone number, which expands email data outside the mailbox and could misdirect private summaries if copied unchanged.
Install Mechanism
The npm install path and dependencies are ordinary for a Node IMAP CLI, but the documentation says .env is already ignored by git while the artifact does not include a .gitignore or .env.example.
Credentials
IMAP credentials, network access, and optional certificate relaxation are coherent for ProtonMail Bridge or IMAP usage, but IMAP_REJECT_UNAUTHORIZED=false should only be used for trusted local/self-signed setups.
Persistence & Privilege
setup.sh writes the IMAP password into a persistent local .env file without setting restrictive permissions, and the skill documents recurring cron use that could repeatedly process mailbox content.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install imap-email - After installation, invoke the skill by name or use
/imap-email - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
Added security metadata (skill.json) declaring credentials and install requirements. Removed redundant README.md.
v1.0.2
Include .env configuration template directly in README for easier setup
v1.0.1
Include .env configuration template directly in README for easier setup
v1.0.0
Initial release: Read, search, and manage email via IMAP. Supports ProtonMail Bridge, Gmail, Fastmail, and any standard IMAP server.
Metadata
Frequently Asked Questions
What is IMAP Email Reader?
Read and manage email via IMAP (ProtonMail Bridge, Gmail, etc.). Check for new/unread messages, fetch content, search mailboxes, and mark as read/unread. Works with any IMAP server including ProtonMail Bridge. It is an AI Agent Skill for Claude Code / OpenClaw, with 6047 downloads so far.
How do I install IMAP Email Reader?
Run "/install imap-email" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is IMAP Email Reader free?
Yes, IMAP Email Reader is completely free (open-source). You can download, install and use it at no cost.
Which platforms does IMAP Email Reader support?
IMAP Email Reader is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created IMAP Email Reader?
It is built and maintained by mvarrieur (@mvarrieur); the current version is v1.0.3.
More Skills