# Email Skill

> Send an email to one or more recipients.

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

---


# Email Skill

**Description:** Use this skill to send and read emails (IMAP/SMTP). Designed for Zoho Mail but configurable.
**Capabilities:** `email.send`, `email.search`

## Tools

### `email.send`
Send an email to one or more recipients.

Parameters:
- `to` (string, required): Comma-separated list of recipients.
- `subject` (string, required): The email subject.
- `body` (string, required): The email body (HTML or plain text).
- `cc` (string, optional): CC recipients.
- `bcc` (string, optional): BCC recipients.

### `email.search`
Search for emails in the inbox.

Parameters:
- `query` (string, required): Search query (e.g. `from:example.com`, `subject:Invoice`).
- `limit` (number, optional): Max results (default 10).
- `markRead` (boolean, optional): Mark as read after fetching (default false).

## Configuration (NO HARDCODED SECRETS)
This skill **must not** contain credentials.

It loads secrets from either:
1) A JSON file at `%OPENCLAW_SECRETS_DIR%/email-tool.json` (recommended), or
2) Environment variables (fallback).

Required keys:
- `EMAIL_USER`
- `EMAIL_PASS`

Optional (defaults shown):
- `HOST_IMAP` (imap.zoho.com)
- `PORT_IMAP` (993)
- `HOST_SMTP` (smtp.zoho.com)
- `PORT_SMTP` (465)
- `SECURE_SMTP` (true)

If you are packaging/uploading this skill: run `node scripts/secret-scan.js` first.