← Back to Skills Marketplace
super-imap-smtp-email
by
Subaru0573
· GitHub ↗
· v1.0.0
· MIT-0
101
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install super-imap-smtp-email
Description
Read and send email via IMAP/SMTP. Check for new/unread messages, fetch content, search mailboxes, mark as read/unread, and send emails with attachments. Sup...
Usage Guidance
This skill appears to be an honest IMAP/SMTP client, but it will ask you for email account credentials and save them in plaintext to ~/.config/imap-smtp-email/.env (setup.sh sets permissions to 600). Before installing, consider: 1) Use an app-specific or dedicated email account/password (Gmail app passwords or service-specific authorization codes) rather than your primary account password. 2) Confirm you trust the package source — running npm install will fetch third-party packages. 3) Keep ALLOWED_READ_DIRS and ALLOWED_WRITE_DIRS restrictive to limit which files the skill can read or write. 4) Be aware the setup script sends a test email (network activity). 5) Remove or rotate credentials if you stop using the skill. If you need stronger protection, use a dedicated mailbox or an authentication method that can be revoked (app passwords) rather than long-lived primary credentials.
Capability Tags
Capability Assessment
Purpose & Capability
Name/description match the included code: the scripts implement IMAP receiving and SMTP sending, multi-account support, and attachment handling. Required binaries (node, npm) are appropriate for the provided Node.js scripts. There are no unrelated service credentials requested.
Instruction Scope
SKILL.md and setup.sh instruct the user to run setup.sh which collects IMAP/SMTP credentials and writes them to ~/.config/imap-smtp-email/.env (with chmod 600). The runtime scripts read that config and only permit file reads/writes within ALLOWED_READ_DIRS/ALLOWED_WRITE_DIRS. This scope is appropriate for an email client, but the skill persists sensitive credentials locally and will send a test email during setup and perform network I/O when used.
Install Mechanism
There is no download/install spec — this is instruction/code-only. package.json declares normal npm dependencies (dotenv, imap, imap-simple, mailparser, nodemailer). Running npm install (not provided automatically) would fetch packages from the public registry; the project does not pull arbitrary binaries or remote archives during install.
Credentials
The registry metadata lists no required environment variables, which is accurate for agent env, but the skill requires and stores IMAP/SMTP usernames and passwords in a local .env file. Those credentials are necessary for the stated purpose, but storing them in plaintext (even with file perms 600) is sensitive and worth noting. The fallback .env in the skill directory is also read if the primary config is missing, which could unintentionally expose credentials if placed there.
Persistence & Privilege
always is false and the skill does not request system-wide privileges. It intentionally persists configuration to ~/.config/imap-smtp-email/.env so credentials survive updates — this is expected for an email client. The skill does not modify other skills or system-wide agent settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install super-imap-smtp-email - After installation, invoke the skill by name or use
/super-imap-smtp-email - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
super-imap-smtp-email v1.0.0
- Initial release with full IMAP/SMTP email read/send support.
- Supports multiple accounts with config file and named account prefixes.
- Handles major providers (Gmail, Outlook, 163.com, etc.) and any standard IMAP/SMTP server.
- Includes commands for checking, fetching, searching, marking, listing mailboxes, and sending email (attachments supported).
- Enforces directory whitelisting and secure config file storage for attachments and credentials.
Metadata
Frequently Asked Questions
What is super-imap-smtp-email?
Read and send email via IMAP/SMTP. Check for new/unread messages, fetch content, search mailboxes, mark as read/unread, and send emails with attachments. Sup... It is an AI Agent Skill for Claude Code / OpenClaw, with 101 downloads so far.
How do I install super-imap-smtp-email?
Run "/install super-imap-smtp-email" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is super-imap-smtp-email free?
Yes, super-imap-smtp-email is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does super-imap-smtp-email support?
super-imap-smtp-email is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created super-imap-smtp-email?
It is built and maintained by Subaru0573 (@subaru0573); the current version is v1.0.0.
More Skills