smtp-email-sender

Send emails with attachments and HTML content via SMTP servers.

2.0k|274|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/openakita/openakita --skill smtp-email-sender
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: smtp-email-sender
Source: https://github.com/openakita/openakita/tree/main/skills/smtp-email-sender
Command: npx skills add https://github.com/openakita/openakita --skill smtp-email-sender

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python-dotenv, and includes scripts (resource) components.

What problem does it solve?

Sending emails programmatically requires configuring SMTP credentials, handling authentication quirks like Gmail app passwords, and managing attachments or HTML formatting, which is tedious to set up manually.

Core Features & Use Cases

  • Multi-Provider SMTP Support: Works with Gmail, Outlook, QQ Mail, 163 Mail, and custom enterprise SMTP servers with TLS/SSL.
  • Rich Email Composition: Supports multiple recipients, CC/BCC, HTML bodies, file attachments, and custom sender display names.
  • Configuration & Testing Tools: Includes an interactive setup wizard and a connection test script that sends a verification email.
  • Use Case: Ask the assistant to email a project report PDF to your manager with CC to teammates, and it sends the message through your configured SMTP account.

Quick Start

Send an email to [email protected] with the subject "Meeting Notes" and a short body using my configured SMTP account.

Frequently Asked Questions about smtp-email-sender

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send an email with Python using SMTP?

Run the send_email.py script with --to, --subject, and --body arguments after configuring SMTP_SERVER, SMTP_USERNAME, and SMTP_PASSWORD in a .env file. The script uses Python's smtplib to connect, authenticate, and deliver the message.

How do I send email with attachments via SMTP?

Pass file paths to the --attachment argument, separating multiple files with commas. The script encodes each file as a base64 MIME part and attaches it to the outgoing message.

Why does Gmail SMTP authentication fail with my password?

Gmail rejects regular account passwords for SMTP access. You must enable two-factor authentication and generate an app-specific password at myaccount.google.com/apppasswords, then use that 16-character password instead.

Does this work with Outlook, QQ Mail, or enterprise email?

Yes, it supports Outlook (smtp-mail.outlook.com), QQ Mail (smtp.qq.com), 163 Mail (smtp.163.com), and custom enterprise servers. Set the appropriate server, port, and TLS option in the .env configuration.

What are the attachment size limits when sending email via SMTP?

Attachment limits depend on the provider: Gmail allows up to 25MB and Outlook up to 20MB. For larger files, the documentation recommends sharing a cloud storage link instead of attaching directly.