Recipe: Multi-Account Review
For users with multiple email accounts, review each account's inbox status and present a unified summary with per-account breakdown.
Prerequisite: Read the
base skill for command reference and filter syntax.
Access level required: read-only.
Steps
Step 1: Discover all accounts
Note each account email, its access level, and associated calendars and teams.
Step 2: Check folders per account
For each account, see the folder structure and message counts:
bash
spark folders user@work.com
spark folders user@personal.com
spark folders user@sideproject.com
Step 3: Review unread mail per account
For each account, check unread across key categories:
bash
spark emails user@work.com --filter "is:unread"
spark emails user@personal.com --filter "is:unread"
spark emails user@sideproject.com --filter "is:unread"
For a category-level breakdown on the most active account:
bash
spark emails user@work.com --filter "category:priority is:unread"
spark emails user@work.com --filter "category:personal is:unread"
Step 4: Cross-account priority check
Check priority mail across all accounts at once:
bash
spark emails Inbox --filter "category:priority is:unread"
This uses the unified inbox to surface priority items regardless of which account received them.
Step 5: Present the summary
Report per account:
- work@company.com: N unread (X priority, Y people)
- personal@gmail.com: M unread
- side@project.com: K unread
Highlight cross-account priorities and any account that needs immediate attention.
Tips
- Start with to discover all configured accounts and their access levels.
- The unified inbox () aggregates across all accounts - use it for cross-account priority checks.
- Per-account browsing (
spark emails user@example.com
) keeps things separated when the user wants to focus on one context.
- Use to understand each account's folder structure before browsing specific folders.
- Some accounts may be read-only while others have triage access. shows the access level for each.
- For users with work + personal accounts, suggest processing them separately to maintain mental context.
- Combine with for a deep dive into the most active account.