Introduction

MuffinBite started as a small side project born out of frustration with repetitive email outreach tasks. It was designed to make sending personalized bulk emails effortless, attaching files, and managing campaigns directly from your terminal: fast, clean, and reliable.
Over time, MuffinBite grew beyond a simple script into a powerful CLI-based automation tool built with Python. It supports both the Gmail API and any SMTP service provider, giving you complete flexibility and control over your email campaigns.
Today, whether you're a small business owner, marketer, or developer, MuffinBite empowers you to simplify and scale your email outreach without relying on expensive third-party platforms or worrying about sending limits. What began as a tiny idea, a tool to save time, has grown into a framework that blends automation, personalization, and ease-of-use into one seamless experience.

Features

  • Attach unlimited files of any type
  • Send 500 emails per day using the Gmail API
  • Log successful and failed email attempts to CSV files
  • Personalize email content using CSV/Excel data sources
  • Detailed error logging to file when debug mode is enabled
  • SMTP support for ESPs such as Brevo, Mailgun, Postmark, and others
  • Set a custom time delay between sending emails to avoid spam filters
  • Run shell commands directly from the MuffinBite CLI using “!command”
  • Send 500 HTML template emails per day with embedded images (base64 supported)
  • Insert variables into subject lines and email bodies for dynamic outreach
  • Test mode: send emails using test data before running real campaigns
  • Add custom HTML signatures to all outgoing emails (with enable/disable toggle)
  • Configure all settings (user, provider, debug, delay, signature, etc.) via CLI
  • Create, list, show, and delete campaigns with subject, template, attachments, CC/BCC, etc.

Upcoming

  • Fetch drafts directly from Gmail
  • Google Sheets integration for recipient data
  • Unit Tests support
Requirements