Email

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": "you@gmail.com",
    "senderPassword": "your-app-password"
  }
}

For Gmail, use an App Password.

Usage/Commands

python {skill_path}/send_email.py \
  --to "recipient@example.com" \
  --subject "Hello" \
  --body "Message body here"

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