email

name	email
description	Send emails via SMTP. Supports plain text, HTML, attachments, CC/BCC. Use when: the user asks to send an email, notification, message, or report. NOT for: reading/receiving mail (use google_workspace for Gmail), sending via Gmail API (use google_workspace instead).
metadata	{"emoji":"✉️"}

Email (SMTP)

When to Use

• Send emails through SMTP (Gmail, Outlook, custom server)
• Notifications, messages, or reports
• Emails with CC, BCC, or HTML body
• When user explicitly asks to "send an email"

When NOT to Use

• Reading or searching Gmail — use google_workspace with gog
• Sending via Gmail API — use google_workspace gmail send
• Tasks that don't involve sending email

Setup

Configure in pythonclaw.json (or the Config dashboard):

"skills": {
  "email": {
    "smtpServer": "smtp.gmail.com",
    "smtpPort": 587,
    "senderEmail": "[e-mail]",
    "senderPassword": "your-app-password"
  }
}

For Gmail, use an App Password.

Usage/Commands

python {skill_path}/send_email.py \
  --to "[e-mail]" \
  --subject "Hello" \
  --body "Message body here"

Option	Description
--to	Recipient address (required)
--subject	Subject line
--body	Message body
--cc "[e-mail],[e-mail]"	CC recipients
--bcc "[e-mail]"	BCC recipients
--html	Treat body as HTML

Notes

• Always confirm before sending on behalf of the user
• For Gmail, App Password is required (not regular password)
• Credentials are read from skills.email in pythonclaw.json