mcpField
S
spark-recipe-newsletter-cleanup

spark-recipe-newsletter-cleanup

github.com/readdleProductivity154344 installsUpdated 6d ago
Repository

About spark-recipe-newsletter-cleanup

A spark command-line recipe for reviewing and pruning newsletter subscriptions. It helps users remove unwanted mail while summarizing or grouping subscriptions they choose to keep.

Key features

  1. 01List newsletter subscriptions
  2. 02Review sender email threads
  3. 03Unsubscribe or block senders
  4. 04Enable AI summaries for keepers
  5. 05Group messages by sender

Use cases

  1. 01Periodically prune unread subscriptions
  2. 02Block a sender or an entire domain
  3. 03Scan summaries of retained newsletters
  4. 04Reduce inbox clutter from frequent senders

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/readdle/spark-cli-skills --skill spark-recipe-newsletter-cleanup

After installing, type/spark-recipe-newsletter-cleanupin Claude Code to confirm it loaded.

Details

From the project README

Recipe: Newsletter Cleanup

Audit and prune newsletter subscriptions. Block the unwanted, unsubscribe from the noisy, and enable AI summaries for the ones worth keeping.

Prerequisite: Read the use-spark base skill for command reference and filter syntax.

Access level required: triage.

Steps

Step 1: List all newsletters
spark emails Inbox --filter "category:newsletter"

Review the senders. Look for patterns: senders the user never reads, duplicates, or obsolete subscriptions.

Step 2: Review individual newsletters

For each sender the user wants to evaluate:

spark thread <id>
Step 3: Remove unwanted subscriptions

For mailing lists with an unsubscribe mechanism:

spark action unsubscribe <id>

For senders that should be blocked entirely:

spark contact-action blockContact [email protected]

To block an entire domain:

spark contact-action blockDomain example.com
Step 4: Enable AI summaries for keepers

For newsletters the user wants to keep but not read in full:

spark contact-action enableAutosummaryForContact [email protected]
Step 5: Group repetitive senders

For senders that send frequently, group their emails to reduce inbox clutter:

spark contact-action groupEmailsFromContact [email protected]

Tips

  • Start with spark emails Inbox --filter "category:newsletter" --page-size 50 to see a broad list of senders.
  • Ask the user which senders they actually read before blocking anything.
  • unsubscribe works through the mailing list's unsubscribe mechanism - it's cleaner than blocking.
  • blockContact stops all future mail from appearing; blockDomain is more aggressive.
  • Auto-summary generates a brief AI summary at the top of each email from that sender - great for digests.
  • Grouping (groupEmailsFromContact) collapses repeated messages from the same sender into a single entry.
  • Run this recipe periodically (monthly) to keep the newsletter list pruned.

Comments

Markdown supported