mcpField
S
spark-recipe-priority-tuning

spark-recipe-priority-tuning

github.com/readdleProductivity154324 installsUpdated 6d ago
Repository

About spark-recipe-priority-tuning

A Spark recipe for reviewing and adjusting which contacts receive priority treatment. It helps users tune priority classification and notification importance based on their current preferences.

Key features

  1. 01Review recent priority email
  2. 02Mark contacts as primary or remove them
  3. 03Adjust contact notification importance
  4. 04Verify priority classification changes

Use cases

  1. 01Add a new client to priority mail
  2. 02Remove noisy senders from priority
  3. 03Change notification settings for key contacts

MCP support

This is a Spark recipe that guides contact and email settings through Spark commands; the input does not describe an MCP connection.

Install

Copy the command and run it in a terminal.

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

After installing, type/spark-recipe-priority-tuningin Claude Code to confirm it loaded.

Details

From the project README

Recipe: Priority Tuning

Fine-tune who gets auto-prioritized by reviewing the current priority category and adjusting contact-level settings.

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

Access level required: triage.

Steps

Step 1: Review current priority mail
spark emails Inbox --filter "category:priority newer_than:14d"

Look at which senders appear in the priority category. Ask the user: are these the right people? Anyone missing? Anyone who shouldn't be here?

Step 2: Check who's currently marked as primary

Browse priority mail to identify the senders Spark is auto-prioritizing. Note any patterns - are important contacts missing, or are low-priority senders appearing?

Step 3: Add missing VIPs

For contacts whose emails should always be prioritized:

spark contact-action markContactAsPrimary [email protected]

This tells Spark to auto-prioritize all future email from this sender.

Step 4: Remove false priorities

For contacts that are showing up in priority but shouldn't be:

spark contact-action unmarkContactAsPrimary [email protected]
Step 5: Adjust notification importance

For contacts where the user wants push notifications:

spark contact-action markContactAsImportant [email protected]

For contacts that are priority but don't need notifications:

spark contact-action unmarkContactAsImportant [email protected]
Step 6: Verify the changes
spark emails Inbox --filter "category:priority is:unread"

Check that the priority category now reflects the user's preferences. New mail from adjusted contacts will appear in the correct category.

Tips

  • markContactAsPrimary is the strongest signal - it guarantees the contact's emails land in priority.
  • markContactAsImportant controls push notifications, which is separate from category placement.
  • Changes apply to all future mail from the contact, not retroactively to existing emails.
  • Run this recipe after onboarding a new client, joining a new team, or changing roles - priority contacts change with context.
  • When contacts are in the wrong category entirely (not just missing from priority), use spark contact-action changeCategoryPersonal / changeCategoryNotification / changeCategoryNewsletters to reclassify all future mail from that sender.
  • A well-tuned priority category means the user can check just category:priority for a reliable "must-read" view.

Comments

Markdown supported