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...
Rank
62
Safety
84
Downloads
45k
Updated
May 19, 2026
Version
0.0.13
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 44.9K downloads reported by the source. Last updated 5/19/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Adoption signal
- 44.9K downloadsadoption · observed May 19, 2026
- Vendor
- Clawhubvendor · observed May 17, 2026
- Protocol compatibility
- OpenClawcompatibility · observed May 17, 2026
- Adoption signal
- 44.6K downloadsadoption · observed May 17, 2026
- Latest release
- 0.0.13release · observed Apr 15, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17en8axd9552m9fpmxvhkq9xd83gnb1:imap-smtp-email- Install using `clawhub skill install s17en8axd9552m9fpmxvhkq9xd83gnb1:imap-smtp-email` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/gzlicanyi/imap-smtp-email before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-gzlicanyi-imap-smtp-email-2/snapshot"
Documentation
CLAWHUB
89,886 characters of source documentation, loaded on request.
Extracted files
3 files captured from the source.
SKILL.md
---
name: 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. Supports multiple accounts. Works with any IMAP/SMTP server including Gmail, Outlook, 163.com, vip.163.com, 126.com, vip.126.com, 188.com, and vip.188.com.
metadata:
openclaw:
emoji: "📧"
requires:
bins:
- node
- npm
env:
- IMAP_HOST
- IMAP_USER
- IMAP_PASS
- SMTP_HOST
- SMTP_USER
- SMTP_PASS
primaryEnv: SMTP_PASS
---
# IMAP/SMTP Email Tool
Read, search, and manage email via IMAP protocol. Send email via SMTP. Supports Gmail, Outlook, 163.com, vip.163.com, 126.com, vip.126.com, 188.com, vip.188.com, and any standard IMAP/SMTP server.
## Configuration
Run the setup script to install dependencies and configure your email account:
```bash
bash setup.sh
```
If running commands manually without setup.sh, install dependencies first:
```bash
npm install --production
```
Configuration is stored at `~/.config/imap-smtp-email/.env` (survives skill updates). If no config is found there, the skill falls back to a `.env` file in the skill directory (for backward compatibility).
### Config file format
```bash
# Default account (no prefix)
IMAP_HOST=imap.gmail.com
IMAP_PORT=993
[email protected]
IMAP_PASS=your_password
IMAP_TLS=true
IMAP_REJECT_UNAUTHORIZED=true
IMAP_MAILBOX=INBOX
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_SECURE=false
[email protected]
SMTP_PASS=your_password
[email protected]
SMTP_REJECT_UNAUTHORIZED=true
# File access whitelist (security)
ALLOWED_READ_DIRS=~/Downloads,~/Documents
ALLOWED_WRITE_DIRS=~/Downloads
```
## Multi-Account
You can configure additional email accounts in the same config file. Each account uses a name prefix (uppercase) on all variables.
### Adding an account
Run the setup script and choose "Add a new account":
```bash
bash setup.sh
```
Or manually add prefixed variables to `~/.config/imap-smtp-email/.env`:
```bash
# Work account (WORK_ prefix)
WORK_IMAP_HOST=imap.company.com
WORK_IMAP_PORT=993
[email protected]
WORK_IMAP_PASS=password
WORK_IMAP_TLS=true
WORK_IMAP_REJECT_UNAUTHORIZED=true
WORK_IMAP_MAILBOX=INBOX
WORK_SMTP_HOST=smtp.company.com
WORK_SMTP_PORT=587
WORK_SMTP_SECURE=false
[email protected]
WORK_SMTP_PASS=password
[email protected]
WORK_SMTP_REJECT_UNAUTHORIZED=true
```
### Using a named account
Add `--account <name>` before the command:
```bash
node scripts/imap.js --account work check
node scripts/smtp.js --account work send --to [email protected] --subject Hi --body Hello
```
Without `--account`, the default (unprefixed) account is used.
### Account name rules
- Letters and digits only (e.g., `work`, `163`, `personal2`)
- Case-insensitive: `work` and `WORK` refer to the same account
- The prefix in `.env` is always uppercase (e.g., `WORK_IMAP_HOST`)
- _meta.json
{
"ownerId": "kn70j4ejnwqjpykvwwvgymmdcd8055qp",
"slug": "imap-smtp-email",
"version": "0.0.13",
"publishedAt": 1776237939871
}package.json
{
"name": "imap-smtp-email-skill",
"version": "1.0.0",
"description": "IMAP/SMTP email tool for Claude. Works with Gmail, Outlook, 163.com, vip.163.com, 126.com, vip.126.com, 188.com, vip.188.com, and any standard IMAP/SMTP server.",
"main": "scripts/imap.js",
"scripts": {
"check": "node scripts/imap.js check",
"fetch": "node scripts/imap.js fetch",
"search": "node scripts/imap.js search"
},
"dependencies": {
"dotenv": "^16.6.1",
"imap": "^0.8.19",
"imap-simple": "^5.1.0",
"mailparser": "^3.9.3",
"nodemailer": "^7.0.13"
},
"keywords": [
"imap",
"smtp",
"email",
"163.com",
"126.com",
"188.com",
"gmail",
"outlook",
"skill"
],
"author": "NetEase",
"license": "MIT"
}AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "44.9K downloads",
"href": "https://clawhub.ai/gzlicanyi/imap-smtp-email",
"sourceUrl": "https://clawhub.ai/gzlicanyi/imap-smtp-email",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-05-19T07:00:56.247Z",
"isPublic": true
},
{
"factKey": "vendor",
"label": "Vendor",
"value": "Clawhub",
"category": "vendor",
"href": "https://clawhub.ai/gzlicanyi/imap-smtp-email",
"sourceUrl": "https://clawhub.ai/gzlicanyi/imap-smtp-email",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-05-17T07:00:30.738Z",
"isPublic": true,
"metadata": {}
},
{
"factKey": "protocols",
"label": "Protocol compatibility",
"value": "OpenClaw",
"category": "compatibility",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-gzlicanyi-imap-smtp-email-2/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-gzlicanyi-imap-smtp-email-2/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-05-17T07:00:30.738Z",
"isPublic": true,
"metadata": {}
},
{
"factKey": "traction",
"label": "Adoption signal",
"value": "44.6K downloads",
"category": "adoption",
"href": "https://clawhub.ai/gzlicanyi/imap-smtp-email",
"sourceUrl": "https://clawhub.ai/gzlicanyi/imap-smtp-email",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-05-17T07:00:30.738Z",
"isPublic": true,
"metadata": {}
},
{
"factKey": "latest_release",
"label": "Latest release",
"value": "0.0.13",
"category": "release",
"href": "https://clawhub.ai/gzlicanyi/imap-smtp-email",
"sourceUrl": "https://clawhub.ai/gzlicanyi/imap-smtp-email",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-04-15T07:25:39.871Z",
"isPublic": true,
"metadata": {}
},
{
"factKey": "handshake_status",
"label": "Handshake status",
"value": "UNKNOWN",
"category": "security",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-gzlicanyi-imap-smtp-email-2/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-gzlicanyi-imap-smtp-email-2/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true,
"metadata": {}
}
],
"events": [
{
"eventType": "release",
"title": "Release 0.0.13",
"description": "- 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",
"href": "https://clawhub.ai/gzlicanyi/imap-smtp-email",
"sourceUrl": "https://clawhub.ai/gzlicanyi/imap-smtp-email",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-04-15T07:25:39.871Z",
"isPublic": true,
"metadata": {}
}
]
}Record generated Oct 9, 2026.
