Email Send Hanson Skill

Use this skill when the task requires sending an email, sending HTML email, adding attachments, reading recent inbox messages, or summarizing recent email activity.

Requirements

The script uses these environment variables:

• EMAIL_HOST: SMTP host.
• IMAP_HOST: IMAP host.
• EMAIL_PORT: SMTP port, default 465.
• EMAIL_USER: mailbox username and sender address.
• EMAIL_PASSWORD: mailbox password or app password.
• EMAIL_USE_SSL: set to false to use STARTTLS instead of SMTP SSL.

It also accepts .env files that use SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASS, and SMTP_SECURE.

Process

1. Confirm recipient, subject, and body before sending email.
2. Use --html-body when the user asks for HTML formatted email. Always include a plain text --body fallback.
3. Use --attachment for existing local files.
4. Use --attachment-content filename=content when the user asks you to create an attachment from provided/generated text content.
5. Read or analyze inbox messages only when the user asks for mailbox inspection.
6. Return the script JSON result directly or summarize the important fields.

Script

Use scripts/server.py.

Examples:

uv run langchain-skills script email-send-hanson server.py --execute send --to user@example.com --subject "Hello" --body "Message"
uv run langchain-skills script email-send-hanson server.py --execute send --to user@example.com --subject "HTML" --body "Plain fallback" --html-body "<h1>Hello</h1><p>HTML body</p>"
uv run langchain-skills script email-send-hanson server.py --execute send --to user@example.com --subject "Inline attachment" --body "See attachment" --attachment-content "notes.txt=Generated attachment text"
uv run langchain-skills script email-send-hanson server.py --execute send --to user@example.com --subject "File attachment" --body "See attachment" --attachment .\report.pdf
uv run langchain-skills script email-send-hanson server.py --execute read --limit 5
uv run langchain-skills script email-send-hanson server.py --execute analyze --limit 10