Recipe: Schedule a Meeting

use-spark

Steps

Step 1: Look up attendee emails

spark contacts "attendee name"

Step 2: Find mutual availability

spark availability --tomorrow --attendees alice@co.com,bob@co.com

spark availability --start 2026-04-10 --end 2026-04-11 --attendees alice@co.com,bob@co.com

spark availability --week --attendees alice@co.com,bob@co.com

Step 3: Present the options

• Date and time range for each slot
• Duration of each slot (so the user knows if a 1-hour meeting fits)

Step 4: Narrow down if needed

spark availability --start 2026-04-10 --end 2026-04-14 --attendees alice@co.com,bob@co.com

spark availability --start 2026-04-10 --end 2026-04-11 --attendees alice@co.com
spark availability --start 2026-04-10 --end 2026-04-11 --attendees bob@co.com

Tips

• availability

  respects working hours (08:00-20:00) and skips weekends automatically.
• Events marked as "free" in the calendar are ignored - they don't block availability.
• Without

  --attendees

  , the command shows the user's own free time.
• For large groups, narrow the date range to get focused results.
• If the user provides names instead of emails, use

  spark contacts

  first to resolve them.
• The free slots are computed as mutual windows - times when all attendees and the user are available.