Qq Email

QQ Email Skill

Environment Variables

Credentials are auto-loaded from ~/.qq-email/.env. Environment variables take precedence over file values. See references/SETUP.md for setup instructions.

CLI Scripts

Send Email

NODE_PATH=$(npm root -g) node scripts/send.js \
  --to "recipient@example.com" \
  --subject "Test Email" \
  --body "Hello, this is a test."

Arguments:

If both --body and --html are provided, the email is sent as multipart with both plain text and HTML alternatives.

Output: JSON to stdout.

Success:

{
  "status": "success",
  "messageId": "<abc123@qq.com>",
  "to": "recipient@example.com",
  "subject": "Test Email"
}

Error:

{
  "status": "error",
  "message": "Missing required argument: --to"
}

Exit code: 0 on success, 1 on error.

Examples

Plain text email:

NODE_PATH=$(npm root -g) node scripts/send.js \
  --to "user@example.com" \
  --subject "Daily Report" \
  --body "All systems operational."

HTML email from file:

NODE_PATH=$(npm root -g) node scripts/send.js \
  --to "user@example.com" \
  --subject "Weekly Report" \
  --html report.html

Email with attachments:

NODE_PATH=$(npm root -g) node scripts/send.js \
  --to "user@example.com" \
  --subject "Report with Data" \
  --body "Please find the attached files." \
  --attach data.csv \
  --attach chart.png

Custom sender:

NODE_PATH=$(npm root -g) node scripts/send.js \
  --to "user@example.com" \
  --subject "From Alt Account" \
  --body "Sent from a different address." \
  --from "alt@qq.com"

SMTP Configuration

Notes

• The --attach flag can be repeated multiple times for multiple attachments
• HTML body is read from a file path, not inline HTML string
• All credentials come from ~/.qq-email/.env or environment variables — never hardcode
• nodemailer must be globally installed (npm install -g nodemailer)