# Smtp Sender

> A skill to send emails with support for markdown, HTML text, and attachments, leveraging existing SMTP configuration in `{skill~}/smtp-config.json`. Includes retry logic and logging.

- Skill: `modbender/smtp-sender` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add modbender/smtp-sender`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/smtp-sender/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/smtp-sender

---


# Custom SMTP Sender

Custom skill to send emails with advanced options including HTML/Markdown conversion, attachments, and retry handling. Integrates existing configuration, ensuring secure and reliable operations.

## Features
- **HTML/Markdown support**: Compose emails using markdown converted to HTML.
- **Attachments**: Include one or more files easily.
- **Retries**: Attempts to resend in case of temporary failures.
- **Logging**: Maintains a log of sent emails and errors for auditing.

## Prerequisites
- **SMTP Configuration File**: `smtp-config.json` located at `~skill/smtp-config.json`

Example:
```json
{
  "server": "smtp.exmail.qq.com",
  "port": 465,
  "username": "your-email@example.com",
  "password": "your-password",
  "emailFrom": "your-email@example.com",
  "useTLS": true
}
```

Ensure file permissions are secured (chmod 600).

## Usage
Send a basic email:
```bash
python3 ~/.openclaw/workspace/skills/smtp-sender/email_sender.py --to "recipient@example.com" --subject "Hello" --body "你好"
```

Send an HTML email with an attachment:
```bash
python3 ~/.openclaw/workspace/skills/smtp-sender/email_sender.py \
  --to "recipient@example.com" \
  --subject "Weekly Report" \
  --body "**Important updates inside.** See attached." \
  --html \
  --attachments path/to/file.pdf
```

## Error Handling
The tool retries up to 3 times on failure, logging each attempt. Networking or credential issues are reported in detail.

## Future Expansion
- Support for CC/BCC fields
- Scheduling emails (cron integration)
- Email templates

Set up your SMTP-service once, and you’re ready to integrate email into your workflow!