← Back to Skills Marketplace
48588
Downloads
103
Stars
499
Active Installs
16
Versions
Install in OpenClaw
/install 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
Install only if you are comfortable giving the skill read/send access to the configured mailbox. Prefer app passwords or authorization codes over primary account passwords, keep ALLOWED_READ_DIRS and ALLOWED_WRITE_DIRS narrow, and remember that the SMTP test sends a real email to yourself.
Capability Assessment
Purpose & Capability
The documented purpose is IMAP/SMTP email access, and the artifacts implement matching commands for checking, fetching, searching, marking read/unread, downloading attachments, and sending mail.
Instruction Scope
The skill gives the agent powerful mailbox actions, but they are exposed as explicit CLI commands rather than hidden automation; outbound recipients, mailbox UIDs, and file paths are user-command inputs.
Install Mechanism
setup.sh installs normal npm dependencies and interactively writes configuration under ~/.config/mail-skills/.env with chmod 600; this is coherent, though it means credentials are persisted locally.
Credentials
Network access is limited to configured IMAP/SMTP providers and package installation, and local file access for attachments/body files is constrained by ALLOWED_READ_DIRS and ALLOWED_WRITE_DIRS.
Persistence & Privilege
The main persistence is a local .env file containing email credentials and allowed file directories; no background worker, scheduled task, privilege escalation, or hidden persistence was found.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install imap-smtp-email - After installation, invoke the skill by name or use
/imap-smtp-email - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.0.16
- Removed the sample file skill-card.md.
- No user-facing features or functional changes.
v0.0.15
0.0.15
- No changes detected in this version; documentation and skill features remain unchanged.
v0.0.14
Shared config system and provider presets
- Switched config to shared file at ~/.config/mail-skills/.env (compatible with caldav-sync skill); legacy ~/.config/imap-smtp-email/.env still supported.
- Introduced PROVIDER-based presets for simpler setup (e.g., PROVIDER=gmail, PROVIDER=163).
- Added scripts/providers.js with built-in IMAP/SMTP server info for major providers.
- Legacy "IMAP_HOST", "IMAP_USER" formatting still accepted for backward compatibility.
- Added sample package-lock.json for consistent dependency installs.
v0.0.13
- Updated environment variable requirements in the skill metadata (`metadata.openclaw.requires.env` and `metadata.openclaw.primaryEnv`)
- Removed obsolete metadata fields for bin requirements, config paths, and credentials
- No changes to code or user-facing features
v0.0.12
- Added metadata clarifying required configuration file location, permissions, and stored credentials.
- Documented explicit required environment variables for account setup.
- Updated configuration section to clarify running setup and install steps.
- No code or feature changes; documentation and metadata improvements only.
v0.0.11
- Added exmail.qq.com to the list of supported/common email servers.
- No other changes detected.
v0.0.10
Multi-account support and config improvements:
- Added support for multiple email accounts via prefixing in config (e.g., WORK_IMAP_HOST).
- Introduced a shared config file at `~/.config/imap-smtp-email/.env` that persists across updates.
- New setup process: configure and manage accounts using `setup.sh`.
- All commands can now use `--account <name>` to specify which account to use.
- New commands to list all configured accounts.
- Added file access whitelisting for security (ALLOWED_READ_DIRS/ALLOWED_WRITE_DIRS).
v0.0.9
- Clarified configuration and troubleshooting instructions for Gmail accounts.
- Added explicit notes that Gmail requires an App Password (not your regular password) for IMAP and SMTP.
- Provided a link to Google's App Password generation page.
- Improved security notes to highlight App Password requirements for Gmail.
- No functional changes; documentation updates only.
v0.0.8
- Updated skill metadata schema to use the new "openclaw" format (replacing "clawdbot").
- Environment variable requirements, binaries, and primary credential are now specified under the new metadata structure.
- No code or documentation changes to features, usage, or commands; this update is metadata only.
v0.0.7
- Added enhanced metadata for setup automation, bin requirements, and npm package installs.
- Introduced a setup script (`setup.sh`) for easier email credential configuration.
- No changes to functional scripts or core documentation.
v0.0.6
- Added documentation for optional environment variables in the skill metadata.
- Designated primary credentials as IMAP_PASS and SMTP_PASS in the skill metadata.
- No code changes; documentation/metadata update only.
v0.0.5
- Updated the skill metadata to specify required and sensitive environment variables.
- No code changes; only the SKILL.md file was updated for improved clarity and metadata structure.
v0.0.4
- Added two new environment variables: `IMAP_REJECT_UNAUTHORIZED` and `SMTP_REJECT_UNAUTHORIZED` to control acceptance of self-signed TLS certificates.
- Updated documentation to include instructions and usage for the new TLS certificate handling options.
- No code changes; update is documentation and configuration-related only.
v0.0.3
- Added structured metadata in SKILL.md to specify required environment variables for configuration.
- Documented sensitive variables explicitly in the metadata for enhanced clarity.
- Removed the README.md file.
v0.0.2
- Added documentation for a new `download` IMAP command to download attachments from emails.
- Described options for selecting the output directory and specific attachment files with the new command.
v0.0.1
Initial release: Read, send, and manage email via IMAP and SMTP with support for popular providers.
- Check for new/unread emails, fetch content, and search mailboxes
- Mark emails as read or unread
- Send emails with attachments (supports plain text and HTML)
- Works with IMAP/SMTP servers from Gmail, Outlook, 163.com, and more
- Command-line usage with flexible arguments and email search filters
- Provides setup, configuration, and troubleshooting guidance
Metadata
Frequently Asked Questions
What is 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 48588 downloads so far.
How do I install imap-smtp-email?
Run "/install imap-smtp-email" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is imap-smtp-email free?
Yes, imap-smtp-email is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does imap-smtp-email support?
imap-smtp-email is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created imap-smtp-email?
It is built and maintained by gzlicanyi (@gzlicanyi); the current version is v0.0.16.
More Skills