mcpField
S
spark-recipe-schedule-meeting

spark-recipe-schedule-meeting

github.com/readdleProductivity154336 installsUpdated 6d ago
Repository

About spark-recipe-schedule-meeting

A Spark skill recipe for finding meeting times that work for all attendees. It resolves names to email addresses, checks shared availability, and presents slots with their durations.

Key features

  1. 01Resolve attendee names to emails
  2. 02Check mutual availability by date
  3. 03Include slot durations in options
  4. 04Broaden or isolate availability checks

Use cases

  1. 01Find a time for a group meeting
  2. 02Identify which attendee blocks a proposed window

Install

Copy the command and run it in a terminal.

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

After installing, type/spark-recipe-schedule-meetingin Claude Code to confirm it loaded.

Details

From the project README

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 [email protected],[email protected]

For a specific date range:

spark availability --start 2026-04-10 --end 2026-04-11 --attendees [email protected],[email protected]

For the full week:

spark availability --week --attendees [email protected],[email protected]
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 [email protected],[email protected]

Or check individual availability to find who's blocking:

spark availability --start 2026-04-10 --end 2026-04-11 --attendees [email protected]
spark availability --start 2026-04-10 --end 2026-04-11 --attendees [email protected]

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.

Comments

Markdown supported