logo

Introduction

MuffinBite is a Python-based interactive CLI tool for sending personalized bulk emails using predefined campaigns and explicit, user-triggered execution. Emails are sent only when a user runs a command in the CLI.
MuffinBite does not run background jobs, scheduled tasks, queues, analytics services, or automated workers. There is no implicit execution, hidden automation, or always-on process — every action is initiated intentionally by the user.
The tool is designed around a simple, campaign-driven workflow. You create campaigns, attach files, define templates, provide recipient data via CSV or Excel files, and execute email sends directly from your terminal. This model ensures transparency, predictability, and full control over when and how emails are sent.
MuffinBite supports both the Gmail API and standard SMTP providers. This makes it suitable for developers, freelancers, and small teams who prefer local tooling and file-based workflows over hosted dashboards or opaque third-party platforms.

Design Philosophy

MuffinBite is intentionally designed around a few core principles that shape every feature in the tool.

  • Explicit Execution: MuffinBite never sends emails automatically. Every email is sent only when a user runs a command in the CLI.
  • No Background Processes: There are no schedulers, queues, daemons, or workers running in the background. The CLI is the single source of truth.
  • Local & Transparent: Campaigns, templates, data files, and logs live on your local machine as plain files that you can inspect and version-control.
  • Predictable Behavior: If a feature is not documented, it does not exist. MuffinBite avoids hidden automation and implicit behavior by design.

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.

Who MuffinBite Is For

Good Fit If You:

  • Prefer CLI tools over web dashboards
  • Want full control over when emails are sent
  • Need campaign-based, personalized outreach
  • Work with CSV or Excel recipient data
  • Care about transparency and predictable behavior

Not a Good Fit If You:

  • Need scheduled or automated email sending
  • Want a hosted web dashboard or analytics UI
  • Expect background jobs or drip campaigns
  • Prefer no-code marketing platforms
Requirements