spark-recipe-schedule-meeting

name	spark-recipe-schedule-meeting
description	Find mutual availability with attendees and suggest meeting times.
metadata	{"version":"1.0.0","requires":{"skills":["use-spark"],"accessLevel":"read-only"}}

Recipe: Schedule a Meeting

Find mutual availability with attendees and present time slot options for scheduling.

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

Access level required: read-only.

Steps

Step 1: Look up attendee emails

spark contacts "attendee name"

Repeat for each attendee to get their email addresses.

Step 2: Find mutual availability

For tomorrow:

spark availability --tomorrow --attendees [e-mail],[e-mail]

For a specific date range:

spark availability --start 2026-04-10 --end 2026-04-11 --attendees [e-mail],[e-mail]

For the full week:

spark availability --week --attendees [e-mail],[e-mail]

Step 3: Present the options

List the available time slots for the user to choose from. Include:

• 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

If no slots work, try a broader window:

spark availability --start 2026-04-10 --end 2026-04-14 --attendees [e-mail],[e-mail]

Or check individual availability to find who's blocking:

spark availability --start 2026-04-10 --end 2026-04-11 --attendees [e-mail]
spark availability --start 2026-04-10 --end 2026-04-11 --attendees [e-mail]

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.