HueLifeCMO Knowledge Base

Spark CLI — agent-driven inbox triage (the 34K-unread play)

Compiled June 2026 from Spark's official docs, launch blog (May 13, 2026), and the open-source skills repo. This is the most direct tool we found for the CEO's backlog.

What it is

A command-line interface that exposes Spark's data (email, calendar, contacts, meeting notes) to AI agents — Claude Code, Cursor, OpenClaw, any MCP-compatible agent. It reads from Spark Desktop's local data store on a Mac, so nothing new is uploaded to a cloud. Works with every provider Spark supports — Gmail, Outlook, Exchange, iCloud, IMAP (so the CEO's Outlook/365 account is supported).

Two access tiers

Tier Cost What the agent can do
Read Free, all users Search, summarize, fetch context, read threads, view calendar/contacts/notes
Triage Included in Spark Pro ($199–$200/yr) Everything in Read plus: draft/reply/forward/edit, archive/label/pin/snooze/move, assign in shared inboxes, and bulk operations across many emails and accounts

Why it's the right tool for 34,000 unread

Readdle ships open-source "recipes" (github.com/readdle/spark-cli-skills) — and several target exactly this problem: - recipe-vacation-catchup"Process a large backlog after time away with batch processing." This is the 34K use case by name. - recipe-inbox-by-category — process the inbox in priority order by smart category. - recipe-inbox-zero — drive the inbox to zero, category-first. - recipe-new-sender-review — burn down GateKeeper's new-sender queue (accept/block). - recipe-draft-batch, recipe-multi-account-review, morning/end-of-day/weekly digests. - Personas: Executive Assistant, Notification Hygiene (bulk-archive noisy senders), Priority Tuning, Founder Mode.

The agent can bulk-archive/label across the whole backlog based on rules you describe in plain language ("archive everything older than 30 days from no-reply senders; label anything from a customer domain; surface anything addressed to me personally"). That's the safe way to clear 34K without 50-at-a-time clicking.

Setup (one-time)

  1. Mac required — Spark CLI is macOS only. Spark Desktop must be installed and running, signed into the account(s) you want to triage.
  2. Add the CEO's Outlook/365 account to Spark Desktop.
  3. In Spark: Settings → AI Agents → Spark CLI Setup, follow prompts.
  4. Set per-account level: Settings → AI Agents → Spark CLI Accessread-only or triage (triage needs Pro).
  5. Connect your agent (Claude Code, etc.). Install recipes from the GitHub repo.

Caveats / things to decide

The kicker for us

This Claude Code environment already has a use-spark skill. If Spark Desktop + CLI is set up on this Mac with the relevant account connected, I can drive the triage directly from here — run recipe-vacation-catchup against the backlog, review what it proposes, and bulk-clear safely.

Sources