email-cli-tool 0.2.1

A simple CLI tool for sending emails with plain text, HTML, and file attachments

email-cli-tool

A simple CLI tool for sending emails with plain text, HTML, and file attachments.

中文文档

Features

• Send plain text / HTML / mixed format emails
• Attach multiple files and images
• Multiple recipients support
• Direct SMTP connection (SSL / STARTTLS)
• Interactive configuration wizard
• Read body content from stdin

Installation

# From PyPI (latest)
pip install email-cli-tool

# Install a specific version
pip install email-cli-tool==0.2.0

# Upgrade an existing install
pip install --upgrade email-cli-tool

# Or with uv
uv tool install email-cli-tool          # latest
uv tool install email-cli-tool==0.2.0   # specific version

The emailcli skill install command requires version 0.2.0 or newer.

Quick Start

1. Initialize Configuration

emailcli init

Follow the prompts to enter your SMTP settings. Example for Gmail:

Field	Value
From address	[e-mail]
SMTP host	smtp.gmail.com
SMTP port	465
SMTP username	[e-mail]
SMTP password	App password
Encryption	ssl

2. Send Emails

# Plain text
emailcli send --to [e-mail] --subject "Hello" --body "Hello World"

# HTML format
emailcli send --to [e-mail] --subject "Notice" \
  --html "<h1>Title</h1><p>Body content</p>"

# With attachments
emailcli send --to [e-mail] --subject "Report" \
  --body "Please see attachments" \
  --attach report.pdf \
  --attach photo.png

# Multiple recipients
emailcli send \
  --to [e-mail] \
  --to [e-mail] \
  --subject "Broadcast" --body "Hello everyone"

# HTML body from file
emailcli send --to [e-mail] --subject "Newsletter" \
  --html-file template.html

# Read body from stdin
echo "Content" | emailcli send \
  --to [e-mail] --subject "Piped" --body -

Command Reference

emailcli send

Option	Required	Repeatable	Description
--to	✅	✅	Recipient email address
--subject	✅		Email subject
--body			Plain text body, - reads from stdin
--html			HTML body string (mutually exclusive with --html-file)
--html-file			Read HTML body from file (mutually exclusive with --html)
--attach		✅	Attachment file path
--from			Override sender address from config

At least one of --body, --html, or --html-file is required.

emailcli init

Interactively create the configuration file at ~/.emailcli/config.yaml.

emailcli config show

Display current configuration (password is masked).

emailcli skill install

Install the send-email agent skill so Claude Code or Codex can send mail for you.

# Install for both Claude Code and Codex (default)
emailcli skill install

# Only one agent
emailcli skill install --target claude
emailcli skill install --target codex

Writes SKILL.md to ~/.claude/skills/send-email/ and/or ~/.codex/skills/send-email/.

Configuration

Path: ~/.emailcli/config.yaml

from: [e-mail]
smtp:
  host: smtp.gmail.com
  port: 465
  username: [e-mail]
  password: your-app-password
  encryption: ssl  # ssl | starttls | none

Development

# Install dependencies
uv sync

# Run tests
uv run pytest -v

# Run locally
uv run emailcli --help

License

MIT