mcpField
S
spark-recipe-label-organize

spark-recipe-label-organize

github.com/readdleProductivity154329 installsUpdated 6d ago
Repository

About spark-recipe-label-organize

A Spark skill recipe for organizing email with labels and folders. It guides users through finding messages, applying or removing labels, moving misfiled mail, and verifying the results.

Key features

  1. 01Review folders and labels
  2. 02Search for relevant emails
  3. 03Attach or detach labels
  4. 04Move misfiled emails
  5. 05Verify organized messages

Use cases

  1. 01Apply project labels to email
  2. 02Correct labels applied to messages
  3. 03Move misfiled email to a folder

Install

Copy the command and run it in a terminal.

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

After installing, type/spark-recipe-label-organizein Claude Code to confirm it loaded.

Details

From the project README

Recipe: Label & Folder Organize

Organize emails using labels and folders. Attach project labels, detach incorrect ones, and move misfiled emails to the right location.

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

Access level required: triage.

Steps

Step 1: Review current folder and label structure
spark folders

For a specific account:

spark folders [email protected]

Note the existing labels and their message counts. Identify labels that are empty or no longer relevant.

Step 2: Identify emails that need labeling

Search for project-related or topic-related emails that should be labeled:

spark search "project name"
spark emails --filter "from:[email protected] newer_than:30d"
Step 3: Attach labels

Add a label to an email without removing it from its current location:

spark action attachLabel <id> --folder "[email protected]:ProjectAlpha"

Label multiple emails in a batch:

spark action attachLabel <id1> --folder "[email protected]:ProjectAlpha"
spark action attachLabel <id2> --folder "[email protected]:ProjectAlpha"
Step 4: Detach incorrect labels

Remove a label that was applied incorrectly:

spark action detachLabel <id> --folder "[email protected]:WrongLabel"
Step 5: Move misfiled emails

Move emails to the correct folder:

spark action moveToFolder <id> --folder "[email protected]:Projects"
Step 6: Verify

Browse the organized label to confirm the right emails are there:

spark emails [email protected]:ProjectAlpha

Tips

  • Use folders to discover the exact qualified names for labels (e.g., [email protected]:MyLabel).
  • attachLabel adds a label without moving the email - the email stays in its current folder too. This is how Gmail labels work.
  • detachLabel removes a label without moving the email elsewhere.
  • moveToFolder physically moves the email to a different folder - use this for IMAP-style organization.
  • For Gmail accounts, prefer attachLabel/detachLabel over moveToFolder since Gmail uses labels rather than folders.
  • Shared inbox labels use the format [email protected]:LabelName or "Team Name:LabelName".
  • Combine with recipe-meeting-prep or project tracking workflows to label threads as part of a larger process.
  • Run this recipe periodically to keep project labels current as new related emails arrive.

Comments

Markdown supported