← Back to Skills Marketplace
6627
Downloads
1
Stars
0
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 an agent access to your mailbox. Use a dedicated app or Bridge-generated password, manually ensure .env is gitignored and chmod 600, keep certificate validation enabled except for trusted local ProtonMail Bridge use, avoid less-secure Gmail access, and replace or remove 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 messages read or unread matches the stated purpose, but it gives the agent access to sensitive email content and mailbox state.
Instruction Scope
The documentation includes recurring cron-based email summaries delivered to iMessage with a hard-coded recipient example and little privacy or minimization guidance.
Install Mechanism
The npm-based install is ordinary and a lockfile is present, but setup.sh writes IMAP credentials to a persistent .env file and the artifact does not include the promised .gitignore or .env.example.
Credentials
IMAP credentials and network access are proportionate for the tool, but the guidance includes disabling certificate validation for self-signed setups and suggests Gmail less-secure app access, which can weaken account protections.
Persistence & Privilege
The skill persists an email password locally without setting restrictive file permissions and documents optional recurring automation that could repeatedly process private email.
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 6627 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