Email Tool

---
name: email-tool
description: "Email Tool"
---

# 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.